Set up rules for object pipelines
Last updated: February 7, 2025
Available with any of the following subscriptions, except where noted:
|
|
|
|
|
To manage how users can create and move records through a pipeline, Super Admins can set rules for their deal, ticket, leads (BETA), and custom object pipelines. The following rules can currently be enforced for each individual pipeline:
- Set stages where new records can be created.
- Restrict skipping stages in the pipeline.
- Restrict moving records backwards in the pipeline.
- Limit who can edit deals in certain stages in the pipeline (Deals only).
- Set up an approval process for deals in the pipeline (Deals only, Sales Hub Enterprise only).
- Require a deal to be created (Leads only, Sales Hub Professional and Enterprise only).
For example, if you restrict users from skipping stages or moving deals backward, editing a deal's stage will look similar to the following:
Set up object pipeline rules
Pipeline rules are enforced when manually creating or updating records on desktop, in the HubSpot mobile app, and via integrations or HubSpot public APIs when a user ID is being passed. Pipeline rules do not apply when creating or editing records via workflows, other APIs, or by users with Super Admin or Edit property settings permissions. In these scenarios, the enabled pipeline rules can be bypassed.
To set up rules:
- In your HubSpot account, click the settings settings icon in the top navigation bar.
- In the left sidebar menu, navigate to Objects, then select the object for which you want to set pipeline rules. Pipeline rules are only available for deals, tickets, and custom objects.
- Navigate to the Pipelines tab.
- Click the Select a pipeline dropdown menu, then select the pipeline for which you want to set rules.
- At the bottom, click the Pipeline Rules tab.
- In each row, toggle the switch on to apply the rule.
- Depending on the rule, customize the settings:
-
- Limit [record] creation to specific stages: select the stages in which new records can be created. With this rule turned on, users will only be able to create records in those stages in HubSpot, as well as via integrations and HubSpot APIs.
- Restrict [records] from skipping stages: to prevent users from skipping any stages in the pipeline, select All stages. To prevent users from skipping certain stages, select Select stages, then select the stages that cannot be skipped. Users will still be able to skip stages if a record is moving to a Closed/Closed Lost stage (for leads Qualified or Unqualified). This rule also applies when editing records via API and integrations.
- Restrict [records] from moving backwards: to prevent users from moving records backwards from any stage in the pipeline, select All stages. To prevent users from moving records backwards one they reach certain stages, select Select stages, then select the stages. With this rule turned on, once a record has been moved to or past the selected stages, users cannot move the record backwards to any stage before the selected stages. This applies when editing in HubSpot, as well as via API and integrations. Users will still be able to move a record backwards from a Closed/Closed Lost ( for leads Qualified or Unqualified) stage if a record is reopened.
-
Please note: for leads, restricting is limited to All stages and can't be customized.
- Control deal editing access: 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 to allow them to edit deals in the selected stages.
- Add approval process for deals (Sales Hub Enterprise only): set up the approval stage.
- Require a deal to be created (Sales Hub Professional only): the user must create a deal if the lead stage is Qualified.
- Click Save.
Once set or updated, pipeline rules are automatically saved and will apply for users with access to the object moving forward. Pipeline rules do not apply to users with Super Admin or Edit property settings permissions.
Please note: when rules are enabled for a pipeline, users will also not be able to bulk edit the pipeline or stage of records in that pipeline.
Edit or turn off pipeline rules
To manage existing pipeline rules:- In your HubSpot account, click the settings settings icon in the top navigation bar.
- In the left sidebar menu, navigate to Objects, then select the object for which you want to update pipeline rules.
- Navigate to the Pipelines tab.
- Click the Select a pipeline dropdown menu, then select the pipeline for which you want to update rules.
- At the bottom, click the Pipeline Rules tab.
- To edit an existing rule, click the edit edit icon in the rule's row. Make your changes in the right panel, then click Save.
- To turn off a rule, click to toggle the switch off. In the dialog box, click Delete pipeline rule to confirm.
Learn more about customizing pipelines.