Configure sales stage rules
Sales stage rules automate pipeline stage transitions based on appointment and membership events. When a qualifying event occurs, the system checks your rules and automatically moves the opportunity to the appropriate stage. This reduces manual updates and keeps your pipeline accurate.
Note: For a conceptual overview of how automation fits into the opportunity lifecycle, see Opportunities overview.
On this page
Before you begin
You need the following permission:
Permission: Configure Rules (under Opportunity in the Sales section) — Required to create and delete sales stage rules. Without it the page shows only Previously Added Rules.
You must have organization-level access to configure sales stage rules.
Pipeline stages must already exist. See Create pipeline stages and lead sources.
Opportunity types must be configured if you want to scope rules to specific types.
Sales stage rules are optional — opportunities can be managed manually without automation.
How sales stage rules work
When an event occurs in the system (such as an appointment being created, cancelled, or closed), the system evaluates your sales stage rules:
- The system identifies opportunities linked to the guest where the event occurred.
- For each open opportunity, the system checks whether the opportunity's current stage matches any "from stage" in your rules.
- If a match is found and the event type matches the rule's trigger, the system transitions the opportunity to the specified "to stage."
- For conditional events (such as cancellation or no-show), the system uses the conditional stage you defined instead of the primary "to stage."
Appointment event triggers
- Appointment created — Triggers when a new appointment is booked.
- Appointment cancelled — Triggers when an appointment is cancelled.
- Appointment no-show — Triggers when a guest is marked as a no-show.
- Appointment deleted — Triggers when an appointment is deleted.
- Appointment closed — Triggers when an appointment is completed and invoiced.
Membership event triggers
- Membership purchased — Triggers when a guest purchases a membership.
- Membership invoice closed — Triggers when a membership invoice is closed.
- Membership invoice voided — Triggers when a membership invoice is voided or cancelled.
Steps
Follow the steps below to create and manage sales stage rules.
Create a rule for services
Worked example: A spa wants opportunities in the "Consultation Booked" stage to advance to "Service Delivered" when a guest completes a facial appointment, but move to "Follow-Up Required" if the appointment is cancelled. They create a services rule scoped to their Facial service, with Change sales stage from set to "Consultation Booked", To sales stage set to "Service Delivered", and the If appointment is subsequently cancelled stage set to "Follow-Up Required".
Navigate to Sales > Configure Sales Stage Rules (or Settings > Opportunities > Sales Stage Rules).
In the Add a New Rule section, in Select item type, select Services.
Configure the rule:
Field Description For opportunity type Select one or more opportunity types this rule applies to. If appointment is booked for Open the service picker and select the services that trigger this rule. Change sales stage from Select one or more pipeline stages. The rule triggers only if the opportunity is currently in one of these stages. To sales stage Select the pipeline stage the opportunity transitions to when the trigger event occurs. If appointment is subsequently cancelled — change sales stage to Stage to move to when the appointment is cancelled. Optional. If appointment is subsequently no-showed — change sales stage to Stage to move to when the guest is marked as a no-show. Optional. If appointment is subsequently closed — change sales stage to Stage to move to when the appointment is completed. Optional. Click Add Rule.
Create a rule for memberships
In the Add a New Rule section, in Select item type, select Memberships.
Configure the rule:
Field Description For opportunity type Select one or more opportunity types this rule applies to. Select memberships Select the membership programs that trigger this rule. Change sales stage from Select one or more pipeline stages the opportunity must be in. To sales stage Select the pipeline stage the opportunity transitions to when the membership event occurs. Membership invoice is subsequently closed — change sales stage to Stage to move to when the membership invoice is closed. Optional. Click Add Rule.
View and manage existing rules
The Previously Added Rules grid displays all configured rules with the columns FOR OPPORTUNITY TYPE, TRIGGER, FOR, CHANGE STAGE FROM, and CHANGE STAGE TO, plus a delete control on each row.
Delete a rule
- In the rules grid, locate the rule you want to delete.
- Click the delete icon in the rule's row.
- Confirm the deletion when prompted.
Note: Deleting a rule does not reverse any stage transitions that already occurred. Opportunities that were transitioned by the deleted rule remain in their current stage.
Tips
- Test rules with a small scope first — configure rules for a single service or membership type to verify the automation works as expected before expanding.
- Consider all event types when creating service rules. If you define a "to stage" for appointment creation but not for cancellation, an opportunity could advance and remain there even if the appointment is cancelled.
- Use conditional stages (cancel, no-show, closed, deleted) to handle exceptions. For example, cancelled appointments might move the opportunity back to an earlier stage.
- The system only applies rules to guests who have open opportunities. If no matching open opportunity exists, no stage transition occurs.
- Review your rules periodically to ensure they still align with your sales process.
Troubleshooting
A stage transition did not occur after an appointment event.
- Confirm that the guest has an open opportunity at the time of the event. The system does not transition stages if no matching open opportunity exists.
- Verify that the opportunity's current pipeline stage is listed in the rule's Change sales stage from field. If the opportunity is in a stage not covered by the rule, no transition occurs.
- Check that the service or membership on the appointment matches the services or memberships configured in the rule.
The rule was saved but does not appear in the rules grid.
- Refresh the page and check whether the rule now appears. The grid refreshes after a successful save.
- If the rule still does not appear, the configuration may have matched an existing rule. The system prevents duplicate rule configurations. Review existing rules to confirm whether an identical rule already exists.
The "Add Rule" action is not available or the form fields are disabled.
- Confirm that your security role has Configure Rules under Opportunity in the Sales section. Without this permission, the page shows only Previously Added Rules and no Add a New Rule form.
- Confirm that you are working in an organization-level view. Sales stage rules can only be configured at the organization level; the form is disabled in center-level views.