Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Add and configure a stage in a playbook

Add and configure a stage in your playbook.

Before you begin

Role required: playbook.admin or pd_author

Review Stages and activities.

Procedure

  1. Add a stage.
ViewSteps
Diagram
  1. Select the + icon after the trigger to add the first stage in your playbook.
  2. In the mini-picker, select the dotted square icon.
    Image omitted: diagram-stage-icon.png
    Square dotted stage icon in Diagram view mini-picker.</li>
BoardIn Board view, click + Add stage.
Your new stage appears, and the Stage properties panel opens.
  1. Fill in the following fields.

    1. Provide the basic details of the stage.
LabelEnter a unique, user-facing name for your stage. This name appears to agents and fulfillers during runtime of your playbook.
DescriptionOptionally, enter some descriptive details about your stage.
Run conditionAfter the stage starts, the stage runs only if specific conditions are met.
Start RuleChoose when you want your stage to start running. Options include:- When playbook starts: Your stage starts running as soon as the playbook starts. - After specific stages: Your stage starts running after specified stage(s) have finished running.
2.  **Show additional options** in the activity for [even more granular control](advanced-instruction-activity.md).

    **Warning:** Changing the advanced property fields of an activity can potentially break your automation. Make sure you understand how the playbook and its activities flow before you make changes.
Display orderWhen there are multiple stages running at the same time, define the order in which stages appear during a playbook run.Note: In Workflow Studio, this can also be helpful when viewing parallel activities in Diagram view.
Start with delaySpecify a duration of time to wait before running an stage whose start rule and conditions have been met. For more information, see Start with delay input properties.
  1. Under the Runtime permissions tab, add sets of users, user groups, user criteria and roles, and define whether they can add optional activities to the stage or restart the stage and its activities.

  2. Click Save and close to finish adding the stage to your playbook.

    You can continue to add more stages to your playbook and fill in fields as described in the previous steps. In the Board view, use the Stage actions menu

Image omitted: icon-menu.png
Stage actions menu to add stages between existing stages.
Stages are created.

What to do next

Add and configure your activities.

Parent Topic:Stages and activities