---
schema_version: "1"
id: 11246909b5e5b581daedf677ab43711bbcced651ca13aff225723fc12fbf08bf
title: Promote Work Items
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/devops_center_promote_work_items.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.devops_center_promote_work_items.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 702f3a55dacd1f31b2301f49187ee4ff892e95f803b415b95ad6cfe0457daf03
description: Move your work items through a predefined sequence of pipeline stages, guiding them from development to production.
products:
  - Salesforce Platform
release: "264"
---
# Promote Work Items

Move your work items through a predefined sequence of pipeline stages, guiding them from development to production. 

### 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>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d18390e106">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d18390e106 ">To promote work items: </td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d18390e106 ">Lifecycle Center Deployment Manager</td>

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

When you promote work items, their associated changes are first merged from the current stage branch to the next, and then deployed to the org for that next stage. 

Lifecycle Center primarily supports stage promotion (also known as work item bundle promotion in DevOps Center (Managed Package)), which makes releases more stable and predictable. After a work item is considered ready to promote, it’s added to the Approved Work Items list. You can promote individual, approved work items into the initial pipeline stage, where they’re combined with other changes intended for the same release. Then, you promote the entire stage as a single, consistent unit to ‌subsequent stages.

To promote individual work items, see [Promote Individual Work Items from a Stage](https://help.salesforce.com/s/articleView?id=platform.devops_center_custom_promote_work_items.htm&release=264.0.0&type=5 "Move approved work items forward without waiting for the entire stage to be ready. Select specific work items for promotion, while others remain in their current stage until they’re ready.").

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-devops_center-264-0-0-production-enus/166010c3-4c34-4087-92ad-aea917baf524/images/icon_note.png)

Note Before a work item is promoted to the next stage, Lifecycle Center Testing automatically runs the test suites assigned to the destination stage — making sure only validated changes advance through your pipeline. See [Testing Before Promotion to the Next Stage](https://help.salesforce.com/s/articleView?id=platform.devops_center_testing_before_promotion.htm&release=264.0.0&type=5 "Lifecycle Center Testing automatically runs assigned test suites before a work item advances to the next pipeline stage, ensuring only validated changes reach Integration, Staging, and Production.").

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-devops_center-264-0-0-production-enus/166010c3-4c34-4087-92ad-aea917baf524/images/icon_note.png)

Note Starting July 1, 2026, Salesforce requires multi-factor authentication (MFA) for users with certain permissions. Users working in development environments and deployment managers promoting to orgs may need to set up MFA according to their organization's security requirements. See [Multi-Factor Authentication for Salesforce Orgs](https://help.salesforce.com/s/articleView?id=xcloud.security_overview_2fa.htm&type=5&language=en_US) and [Prepare Your Org for Salesforce MFA Enforcement](https://admin.salesforce.com/blog/2026/prepare-your-org-for-salesforce-mfa-enforcement).

To view metadata and data changes in a work item, open the work item record page and review the details in the Change List tab.

1. Go to the Pipelines tab and under Approved Work Items, select the work items to promote.
2. Click **Promote Selected**.
    
    The selected work items are promoted to the next stage and are now ready to be promoted as a unit. After all work items for a release are grouped, promote them to the next stage in the pipeline.
3. In the pipeline view, click **Promote Stage**.
4. If you haven’t logged in to the environment for the next pipeline stage from within Lifecycle Center, complete the login process, then click **Promote Stage**.
    
    ![Pipeline with stage promotion button](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-devops_center-264-0-0-production-enus/166010c3-4c34-4087-92ad-aea917baf524/devops_center/images/next_gen_stage_promote.png)
5. In the Promotion Options window, select **Promote now**, the changes to promote, and the Apex tests to run. For details, see [Promotion Options](https://help.salesforce.com/s/articleView?id=platform.devops_center_promotion_options.htm&release=264.0.0&type=5 "The available promotion options depend on if you’re promoting individual work items, work item bundles, or performing a validate-only deployment.").
6. Click **Promote**.
    
    Lifecycle Center merges branches and deploys the work items to the environment associated with the next stage.
7. (Optional) If Lifecycle Center detects a merge conflict for the selected work items, it provides recommendations to resolve merge conflicts using Lifecycle Center MCP tools.
    
    See [Resolve Merge Conflicts with Lifecycle Center MCP Tools](https://help.salesforce.com/s/articleView?id=platform.devops_center_mcp_resolve_merge_conflicts.htm&release=264.0.0&type=5 "Detect, analyze, and resolve merge conflicts directly within your workflow. You can start this process using the Resolve with Agentforce option in the Lifecycle Center UI, which opens the Agentforce Vibes IDE with the Agentforce Vibes Extension and adds the conflict details to your prompt.").

#### See Also

- [Troubleshoot a Stalled Promotion](https://help.salesforce.com/s/articleView?id=platform.devops_center_promotion_stalled.htm&release=264.0.0&type=5 "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.")