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

Restart a playbook

Restart a playbook from the beginning, an activity, or a stage.

Before you begin

Role required: agent or pd_restarter

If your playbook admin has enabled restart in your playbook, you can find the restart action in the action menus of the playbook, stages, or activities. If you are an admin and would like to enable and configure restart for a playbook in Workflow Studio, see Configure restart for Playbooks.

If a stage or activity is not configured to be restartable, you will not see all of the buttons in this procedure.

Note: Certain activities within a playbook cannot be restarted once they have started. Playbooks in a Cancelled, Complete, or Error state also cannot be restarted. However, the opposite is true for activities and stages. Activities and stages must be complete or in an error state before they can be restarted.

Procedure

  1. Restart playbook
  2. Note: Playbooks in a Complete, Error, or Cancelled state cannot be restarted.

    Open your playbook.

  3. To restart the whole playbook:

    1. Hover over the playbook name in the contextual side panel to open the context menu
Image omitted: icon-menu.png
context menu.
2.  Select **Restart playbook**.
Image omitted: restart-playbook-pe.png
Restart playbook button in the context menu
  1. Restart stage
  2. Open your playbook.

  3. Note: Stages and activities must be completed or in an error state before they can be restarted. When a stage or activity is restarted, you may need to:

  4. Complete all restartable stages and activities after it again.

  5. Re-enter information to complete restartable stages and activities again. To restart a stage:

    1. Hover over the name of the stage in the contextual side panel to open the context menu
Image omitted: icon-menu.png
More actions menu.
2.  Select **Restart stage**
Image omitted: restart-stage-pe.png
Restart stage button in the context menu
    .
  1. Restart activity
  2. Open your playbook.

  3. Note: Stages and activities must be completed or in an error state before they can be restarted. When a stage or activity is restarted, you may need to:

  4. Complete all restartable stages and activities after it again.

  5. Re-enter information to complete restartable stages and activities again. To restart an activity:

    1. In the activity card, open the context menu.

    2. Select Restart.

Image omitted: restart-activity-pe.png
Restart button in activity card context menu

Parent Topic:Running Playbooks