Salesforce Docs Portal

Promote Work Items

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

Required Editions

Available in: Lightning Experience in Professional (API access required), Enterprise, Performance, Unlimited, and Developer Editions
Not available in: Government Cloud Plus. Contact your Salesforce account executive for more details.
Not available in: EU Operating Zone. EU Operating zone is a special paid offering that provides an enhanced level of data residency commitment. Lifecycle Center is supported in orgs in the EU that aren’t part of EU OZ, per standard product terms and conditions.
User Permissions Needed
To promote work items: Lifecycle Center Deployment Manager

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.

Note
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.
Note
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 and 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
  5. In the Promotion Options window, select Promote now, the changes to promote, and the Apex tests to run. For details, see Promotion Options.
  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 Also