Skip to content

Set up and customize your deal pipelines and deal stages

Last updated: May 20, 2024

Available with any of the following subscriptions, except where noted:

All products and plans

Deal pipelines help visualize your sales process to predict revenue and identify selling roadblocks. Deal stages are the steps in your pipeline that signal to your sales team that an opportunity is moving toward the point of closing.

If you have Edit property settings access, you can create and edit deal pipelines and stages to best suit your team's needs.

Create a new deal pipeline

If your account has more than one unique sales process, you can create additional pipelines. Separate pipelines are only recommended if your sales processes have unique stages that require different pipelines. Otherwise, you can use the same pipeline across multiple users and teams and manage access via user permissions. For example:

  • Your business has an online direct to consumer sales process with a few stages, such as In cart, Closed Won, and Closed Lost. You also have a wholesale sales process that requires more stages, such as appointment scheduling and contract negotiation. In this scenario, you should create separate pipelines.
  • Your business sells multiple brands and your HubSpot account has teams for each brand. The process to sell products for each brand is the same and you can use the same stages for all sales. In this scenario, it's not recommended to create separate pipelines. Instead, you can use the same pipeline and set Team only user permissions so each team can only access their brand's deals (Professional and Enterprise only).

Please note: only Sales Hub Starter, Professional or Enterprise accounts can create additional pipelines. Learn more about the maximum number of pipelines you can create in your HubSpot account depending on your subscription.


To create a new deal pipeline:
  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Objects > Deals.
  • Click the Pipelines tab.
  • Click the Select a pipeline dropdown menu, then select Create pipeline.

create-deal-pipeline

  • In the dialog box, enter a Pipeline name and click Create.

Once you've added deals to your pipeline, learn how to edit the deals in a pipeline.

Edit or delete deal pipelines

You can also rename, reorder, manage access to, or delete deal pipelines.

Please note: if you connect an ecommerce integration to HubSpot, another pipeline will be automatically added to your account that you cannot modify. 

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Objects > Deals.
  • Click the Pipelines tab.
  • Click the Select a pipeline dropdown menu and select a pipeline.
  • Click the code code icon to view the pipeline's internal name. The internal name is used by integrations and the API.
  • On the right, click the Actions dropdown menu and select one of the following:

edit-existing-pipeline

    • Rename this pipeline: change the pipeline’s name. In the dialog box, enter the new name, then click Rename.
    • Reorder pipelines: change the order of your pipelines. In the pop-up box, drag the pipelines to move them to a new position, then click Save.
    • Manage access: manage which users can view and edit the pipeline.
    • Delete this pipeline: delete the pipeline. In the dialog box, click Delete pipeline to confirm. You can't delete a pipeline if it contains deals. You'll need to delete or move deals to another pipeline before deleting the pipeline.
  • Click Customize board and card view to select the properties that are displayed on the board and board cards for the pipeline.
  • Click Customize deal tags to create and manage color-coded labels that categorize deals (Sales Hub Starter, Professional, and Enterprise only). 
  • To customize automation settings for the pipeline, click the Automate tab.
  • To set up rules for the pipeline, click the Pipeline Rules tab (Sales Hub Professional and Enterprise only).

Add, edit, or delete deal stages in a pipeline

You can use deal stages to categorize and track the progress of your ongoing deals in HubSpot. Each deal stage has an associated probability that indicates the likelihood of closing deals marked with that deal stage. Stage probability is used to determine the weighted amount shown in board view, which is calculated by multiplying the total amount in each stage by the stage probability.

By default, HubSpot includes a sales pipeline with seven deal stages: Appointment scheduled (20%), Qualified to buy (40%), Presentation scheduled (60%), Decision maker bought-in (80%), Contract sent (90%), Closed won (100% Won), and Closed lost (0% Lost). If you have an Asset Marketplace provider account, your account will also have a Marketplace Transactions deal pipeline with a Transactions and Refunded deal stage. 

You can also add your own stages or edit and delete existing stages. To customize the stages in a pipeline:
  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Objects > Deals.
  • Click the Pipelines tab.
  • Click the Select a pipeline dropdown menu, then select the pipeline to edit.
  • To add a new deal stage:

    • Under the existing deal stages, click + Add stage.

    • Enter a deal stage name, then click the dropdown menu in the Deal probability column and select or enter a probability.

Please note: to ensure all sales reports, custom deal or revenue reports, and sales analytics tools process your deals correctly, ensure you at least have deal stages for both Won and Lost under Deal probability.


  • To change the name of an existing deal stage, click the stage's name, then enter a new name in the text box. 
  • To reorder stages, click the stage and drag it to a new position.

  • To view the internal name for a deal stage, hover over the stage and click the code code icon. The internal name is used by integrations and the API.
  • To delete a stage, hover over a stage and click Delete. If there are deals in the stage you're deleting, you'll need to move these existing deals to another stage. To do this in bulk, navigate to the deals index page, and in list view, bulk edit the Deal Stage property.

You can also automate tasks on deal stages when editing or creating a sales pipeline.

Customize properties shown in each deal stage

You can also customize which deal properties are presented to users when manually moving a deal to a specific stage. Users must have Edit property settings permissions to customize deal stage properties.

  • Navigate to the pipeline you want to edit.
  • In the row of a stage, hover over the Conditional stage properties column and click Edit properties.

  • In the dialog box, select the checkboxes next to any new properties you want to appear.

Please note: properties with read-only values (i.e. that aren't set by users, such as score or calculation properties) cannot be used as deal stage properties, and will not appear as options to select. Learn how to include these properties in the About this deal section on a record instead.


  • To require a value for a property, select the checkbox in the Required column (Starter, Professional or Enterprise only). When a property is required, users won’t be able to create a deal in that stage unless they enter a value for that property.

  • To reorder the properties, click and drag them to a new position.

  • To remove a selected property, click the next to that property in the Selected Properties column.
  • Once you've selected your properties, click Next. The properties you've selected will automatically appear when manually creating a new deal in that stage or when moving an existing deal to that stage.

update-deal-stage-properties

  • Once you're done editing, click Save in the bottom left.

Manage access to deals by team or stage (Professional and Enterprise only)

Regardless of your HubSpot subscription, you can update an individual user's access to deals. However, if your account has a Sales Hub Professional or Enterprise subscription, you can also edit deal access based on a user's team and restrict editing access for certain deal stages.

Assign access to deals based on team membership

If your pipeline includes deals assigned to multiple teams, you can configure deal access so that users on a team can only access deals assigned to themselves or other team members. This means multiple teams can share a pipeline without affecting the deals assigned to other teams. 

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left panel, navigate to Users & Teams.
  • To edit an individual user's permissions, click the name of a user on the desired team. To edit multiple users' permissions, select the checkboxes next to the users' names. If the users aren't yet on a team, learn how to create and add users to a team.
  • Click Edit permissions.
  • In the right panel, navigate to the CRM tab.
  • In the Deals row, set the user's view permissions to Team only, then clear the Unassigned checkbox. This will automatically update the edit and delete permissions.

deals-team-only-permissions

  • Click Save. The user(s) must log out and back in for the permissions to take effect.

With these permissions, the users can now only view, edit, or delete deals where they or another user on their team are the owner. If a user is on multiple teams, they can access deals assigned to any of their teams.

Learn more about editing user permissions.

Restrict editing access for specific deal stages

Super admins can set whether deals in specific stages are editable by all users with access to deals, specific users and teams, or only by other users with super admin permissions.

If a stage is limited to super admins or specific users and teams, once a deal enters that stage, only those users will be able to edit the deal or move it to a different stage. Users with deal access can still view deal records in that stage, but can't make changes until an admin moves it to an editable stage.

Depending on user's deal permissions, the most restrictive setting will take precedence to decide if the user can edit deals in each stage. For example:

  • If a user's Edit permission for deals is set to all deals, but they are not allowed to edit deals in a stage, they won't be able to edit deals in the stage.
  • If a user can edit deals in a stage, but their Edit permission for deals is set to none, they won't be able to edit deals in that stage.
  • If a user can edit deals in a stage and their Edit permission for deals is set to owned only or team only, they can edit deals in the stage that they or their team own, but cannot edit other deals in that stage.

Please note: even if a stage is limited to admins, the following behavior is expected:

  • Deals in the stage can still be edited through workflows, the forecast tool, and API requests passed without an associated user ID.
  • Users can still edit associations on deals in the stage if a user has access to other objects (e.g., a user adds the deal as an association on a contact record, which adds the associated contact to the deal).
  • Users can still create and log activities on deals in the stage. 

To avoid certain users editing deals via these methods, update their user permissions for those tools or objects.

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Objects > Deals.
  • Click the Pipelines tab.
  • Click the Select a pipeline dropdown menu, then select the pipeline to edit.
  • Click the Pipeline Rules tab.
  • In the Control deal editing access row, click to toggle the switch on to apply the rule.
  • In the right panel, select the stages which will have limited editing access, then select who should have access: Only super admins or Specific users and teams.
  • If you've selected Specific users and teams, click the Add a user or team dropdown menu, then select the checkboxes of users and teams you'll allow to edit deals in the selected stages.
  • Click Save to confirm.
Learn more about setting rules for deal pipelines.
Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.