---
schema_version: "1"
id: 5dc9cf34b567f10bea0a03293313fc8671951c8fcc300c4b847560ac25e0bae9
title: Debug an Orchestration
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/orchestrator_troubleshoot_debug.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.orchestrator_troubleshoot_debug.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 449f85adc36088faffc6200986d4d4b39cedb33bfcd61363417de8b80af7729e
description: Debug an orchestration in Flow Builder to better understand the path an orchestration takes in different scenarios and the values that variables have at points within the automation. Use rollback mode to debug without making changes to your data. Or debug while making changes to your data.
products:
  - Flow Builder
  - Salesforce Platform
release: "264"
---
# Debug an Orchestration

Debug an orchestration in Flow Builder to better understand the path an orchestration takes in different scenarios and the values that variables have at points within the automation. Use rollback mode to debug without making changes to your data. Or debug while making changes to your data.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col style="width:100%"></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;"><a href="https://help.salesforce.com/s/articleView?id=platform.automate_orchestrator_about_supported_editions.htm&amp;release=264.0.0&amp;type=5" title="Review the supported products and editions for Flow Orchestration.">View supported editions for Flow Orchestration.</a></td></tr></tbody></table>

## Milestones

Orchestration milestones are a part of orchestration log, error, and debug details.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d219511e67">Orchestration Run Milestone</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d219511e70">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Orchestration Run Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e67 ">Start Run</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e70 ">The orchestration run started or was manually resumed.</td>

          </tr>
          <tr class="">
            <td data-label="Orchestration Run Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e67 ">End Run</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e70 ">The orchestration run was completed.</td>

          </tr>
          <tr class="">
            <td data-label="Orchestration Run Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e67 ">Suspend Run</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e70 ">The orchestration run was manually suspended.</td>

          </tr>
          <tr class="">
            <td data-label="Orchestration Run Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e67 ">Cancel Run</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e70 ">The orchestration run was manually canceled.</td>

          </tr>
          <tr class="">
            <td data-label="Orchestration Run Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e67 ">Resume Run</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e70 ">The orchestration run was manually resumed.</td>

          </tr>
          <tr class="">
            <td data-label="Orchestration Run Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e67 ">Fail Run</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e70 ">
              <ul>
                <li>The orchestration run encountered an error.</li>

                <li>A stage within the orchestration run encountered an error.</li>

                <li>A step within the orchestration run encountered an error.</li>

              </ul>
            </td>

          </tr>
        </tbody>
      </table>

Stage milestones are a part of orchestration debugging details.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d219511e162">Stage Milestone</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d219511e165">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Stage Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e162 ">Start Stage</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e165 ">The stage started or was resumed when its parent orchestration run was
              resumed.</td>

          </tr>
          <tr class="">
            <td data-label="Stage Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e162 ">End Stage</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e165 ">
              <ul>
                <li>The stage was completed.</li>

                <li>The stage was in progress when its parent orchestration run was canceled.</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Stage Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e162 ">Suspend Stage</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e165 ">The stage was in progress when its parent orchestration run was manually
              suspended.</td>

          </tr>
          <tr class="">
            <td data-label="Stage Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e162 ">Discontinue Stage</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e165 ">
              <ul>
                <li>The parent orchestration run encountered an error after the stage was
                  completed. </li>

                <li>The parent orchestration run encountered an error while the stage was in
                  progress.</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Stage Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e162 ">Fail Stage</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e165 ">
              <ul>
                <li>The stage encountered an error.</li>

                <li>A background step within the stage encountered an error.</li>

                <li>An autolaunched flow called by a background step within the stage encountered
                  an error.</li>

              </ul>
            </td>

          </tr>
        </tbody>
      </table>

Step milestones are a part of orchestration debugging details.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d219511e266">Step Milestone</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d219511e269">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Step Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e266 ">Start Step</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e269 ">The step started.</td>

          </tr>
          <tr class="">
            <td data-label="Step Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e266 ">End Step</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e269 ">The step was completed.</td>

          </tr>
          <tr class="">
            <td data-label="Step Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e266 ">Discontinue Step</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e269 ">
              <ul>
                <li>The step's stage was completed while the step was in progress.</li>

                <li>The parent orchestration run encountered an error after the step was
                  completed.</li>

                <li>The parent orchestration run encountered an error while the step was in
                  progress.</li>

                <li>The step's stage encountered an error while the step was in progress.</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Step Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e266 ">Fail Step</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e269 ">The step encountered an error.</td>

          </tr>
        </tbody>
      </table>

Work item milestones are a part of orchestration debugging details.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d219511e345">Work Item Milestone</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d219511e348">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Work Item Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e345 ">Start Work Item</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e348 ">The work item was created and assigned.</td>

          </tr>
          <tr class="">
            <td data-label="Work Item Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e345 ">End Work Item</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e348 ">
              <p>The assigned user completed the work item.</p>
              <p style="margin-bottom:0;">When the work item reaches the End
                Work Item milestone, the Completed By field is set to the username of the user or
                credentialed Experience Cloud site visitor who completed the work. When the work
                item reaches this milestone, the Duration field is set to the duration of the step
                in seconds.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Work Item Milestone" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e345 ">Reassign Work Item</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d219511e348 ">The work item was reassigned.</td>

          </tr>
        </tbody>
      </table>

- **[Debug an Orchestration Without Changing Your Data](https://help.salesforce.com/s/articleView?id=platform.orchestrator_troubleshoot_debug_orchestration_rollback_mode.htm&release=264.0.0&type=5)**  
    Debug your orchestration in Flow Builder to ensure that it runs as expected or to determine the cause of unexpected errors. Use rollback mode to debug your orchestration without making changes to your Salesforce data.
- **[Debug an Orchestration and Keep Data Changes](https://help.salesforce.com/s/articleView?id=platform.orchestrator_troubleshoot_debug_orchestration_default_mode.htm&release=264.0.0&type=5)**  
    Test and troubleshoot your orchestration with database updates. Set a start point to skip earlier stages, an end point to stop before later stages, or both to isolate a middle segment. You can also set mock outputs for steps. A step that uses mock output doesn't run its referenced flow or make changes to the Salesforce database. You’re the assigned user for all interactive steps that meet their entry conditions.