---
schema_version: "1"
id: 05236e7cbf9491401d5294541d5ec0cc0f681c08f900dadacddff9ebf4f2704b
title: Custom Promotion
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/devops_center_custom_promotion.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.devops_center_custom_promotion.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: c3667605fb0d0eb4f950cf6108cc0aea6382037820ea890b481a1cce8fc5bd02
description: Select and promote individual work items that are ready for the next pipeline stage by using custom promotion.
products:
  - Salesforce Platform
release: "264"
---
# Custom Promotion

Select and promote individual work items that are ready for the next pipeline stage by using custom promotion.

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

While we recommend stage promotion for stable and predictable releases, custom promotion provides flexibility to move approved work items forward, even if other work items in the same stage require additional work, such as testing.

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

Example You have work items, W1, W2, W3 in the Integration stage. W1 and W2 are ready, but a related work item, W3 requires more work. With custom promotion, you can promote work items, W1 and W2 to UAT, while W3 remains in Integration. You can promote W3 to UAT later when it’s ready.

Lifecycle Center tracks the commit history for each work item. When you promote individual work items from a stage, Lifecycle Center extracts the changes specific to the selected work items. It then creates a change request that contains only the metadata from the selected work items and applies it to the target stage branch. After the prepromotion validation completes, the selected work items move to the next stage. Remaining work items stay in the source stage and maintain their status. This process makes sure that changes remain accurate while providing the flexibility needed for efficient release management.

![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 Always check for dependencies and review the remaining work items in the stage for possible merge issues after promotion. During custom promotion, Lifecycle Center identifies work items in the stage that share metadata components or have dependencies. You can [combine work items](https://help.salesforce.com/s/articleView?id=platform.devops_center_combine_work_items.htm&release=264.0.0&type=5 "Use combine work items to prevent conflicts when promoting individual work items with custom promotion. When work items in a stage share metadata or depend on each other, promoting them individually results in conflicts or blocked promotions.") to prevent potential conflicts.

- **[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.
- **[Combine Work Items in Lifecycle Center](https://help.salesforce.com/s/articleView?id=platform.devops_center_combine_work_items.htm&release=264.0.0&type=5)**  
    Use combine work items to prevent conflicts when promoting individual work items with custom promotion. When work items in a stage share metadata or depend on each other, promoting them individually results in conflicts or blocked promotions.