---
schema_version: "1"
id: cbe899a1dd2d4f2b5e8139170c820efd5a25f34c04655df0fb2a5a73e84eaff7
title: Troubleshoot a Stalled Promotion
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/devops_center_promotion_stalled.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.devops_center_promotion_stalled.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 75fdf90dc36cda40278251557fa968642c6d78319ffff4080b8d3b2b36978a2a
description: A promotion can stall while Lifecycle Center deploys changes to the target environment or merges changes into the target stage branch. Check the deployment and change request to determine where the promotion stalled, and then follow the appropriate recovery procedure.
products:
  - Salesforce Platform
release: "264"
---
# Troubleshoot a Stalled Promotion

A promotion can stall while Lifecycle Center deploys changes to the target environment or merges changes into the target stage branch. Check the deployment and change request to determine where the promotion stalled, and then follow the appropriate recovery procedure.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience in <strong>Professional</strong> (API access required), <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions</td></tr></tbody><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Not available in: <strong>Government Cloud Plus</strong>. Contact your Salesforce account executive for more details.</td></tr></tbody><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Not available in: <strong>EU Operating</strong> Zone. EU Operating zone is a special paid offering that provides an enhanced level of data residency commitment. Lifecycle Center <em>is</em> supported in orgs in the EU that aren’t part of EU OZ, per standard product terms and conditions.</td></tr></tbody></table>

The promotion process has two main operations:

- Lifecycle Center deploys the selected changes to the target environment.
- Lifecycle Center merges the changes into the target stage branch.

If communication from an external service to Lifecycle Center is interrupted during either operation, the promotion status in Lifecycle Center may not reflect the actual result.

A stalled promotion has one of these outcomes:

- The promotion failed: The changes weren’t deployed to the target environment or merged into the target stage branch.
- The promotion succeeded, but its status wasn’t updated: The changes were deployed to the target environment and merged into the target stage branch, but the promotion doesn’t appear as completed in Lifecycle Center.
- The deployment succeeded, but the branch merge failed: The changes were deployed to the target environment but weren’t merged into the target stage branch.

To determine which recovery procedure to use, check the deployment in the target org. If the deployment succeeded, check the associated change request in source control.

![Flow for identifying the type of stalled promotion and choosing a recovery procedure.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-devops_center-264-0-0-production-enus/166010c3-4c34-4087-92ad-aea917baf524/devops_center/images/ts-stalled-promotions-flow-chart.png)

1. Log in to the target org.
2. From Setup, in the Quick Find box, enter Deployment Status, and then select **Deployment Status**.
3. Find the deployment associated with the stalled promotion and check its status.
    - If the deployment failed, see [Fix a Stalled Promotion](https://help.salesforce.com/s/articleView?id=platform.next_gen_devops_center_fix_stalled_promotion.htm&release=264.0.0&type=5 "If a promotion remains in progress after its deployment succeeds or fails, cancel the associated request record. You can manually clean up a stalled promotion in Lifecycle Center.").
    - If the deployment succeeded, continue to the next step.
4. Open the change request (pull request) associated with the stalled promotion.
    
    If a stalled-promotion error appears in Lifecycle Center, use the dropdown menu to open the change request. If the promotion status is **Pushing**, the dropdown menu is unavailable. Open the project repository directly in your source control system.
5. In the source control repository, open the list of pull requests.
6. Find the pull request associated with the stalled promotion.
    - If you promoted all work items in the stage, look for a pull request with a title that begins with `[DO NOT MERGE] For DevOps Center use only - <source stage> to <target stage>`.
    - If you promoted selected work items, look for pull requests whose titles contain the work item IDs, such as `[DevOps Center] Merge WI-000002 to <target stage>`.
    - If you promoted a work item bundle, look for a pull request whose title identifies the source and target stages, such as `[DevOps Center] <source stage> to <target stage>`.
7. Review the pull request status, and then see [Fix a Stalled Promotion](https://help.salesforce.com/s/articleView?id=platform.next_gen_devops_center_fix_stalled_promotion.htm&release=264.0.0&type=5 "If a promotion remains in progress after its deployment succeeds or fails, cancel the associated request record. You can manually clean up a stalled promotion in Lifecycle Center.").
    - If all associated pull requests are merged, the promotion completed but its status wasn’t updated in Lifecycle Center.
    - If any associated pull request remains open, the deployment succeeded but the branch merge failed.