---
schema_version: "1"
id: 23355d10a3cf08c4229ff8b6f69934399ef2c68a55d37357d4cfc1569a06417e
title: How Promotions Work
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/salesforcedx/devops-center-dev/guides/devops-center/devops-center-dev-promotions.md
canonical_url: https://developer.salesforce.com/docs/platform/devops-center-dev/guide/devops-center-dev-promotions.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 9d6e97d15d93cef4ab60bff34a22857eecc62fc57a10e3089d2bbb8eb49d10b5
products:
  - DevOps Center Developer Guide
  - salesforcedx
---

# How Promotions Work

Show the objects involved when a user does an unbundled or bundled promotion.

DevOps Center supports two types of promotions:

-   Unbundled promotion—Users select one or more work items and promote (move) them to the next pipeline stage.
-   Versioned promotion—Work items are combined into a single bundle represented by the Change Bundle object. The bundle is promoted as a single unit to the next pipeline stage. Change bundles have version identifiers, such as 1.0.

The Pipeline Stage object has a Boolean field called Versioned that DevOps Center uses to control how promotions come into a pipeline stage. The value of the field determines what type of pipeline stage it is:

-   Unbundled Stage—A stage that work items are promoted into by users selecting them individually.
-   Bundling Stage—The last unbundled stage in a pipeline. Work items have been promoted individually into this stage, but new change bundles are promoted out of it.
-   Versioned Stage—A stage where change bundles are promoted into.

When an admin creates a pipeline, DevOps Center provides a template of a typical release pipeline that includes a bundling stage. However, you have complete flexibility to configure it based on your preferences. This setup allows users to individually select the work items they want to promote from the Approved Work Items list to the first pipeline stage. Admins can configure subsequent stages as either unbundled or versioned. But if an admin makes a stage versioned, all the stages to the right in the pipeline must also be versioned, and they can’t go back to being unbundled.

-   **[Common Promotion Custom Objects](https://developer.salesforce.com/docs/platform/devops-center-dev/guide/devops-center-dev-promotions-commonobjects.md)**  


    Before we drill down into the details of promotions, let’s first review the common custom objects that both unbundled and bundled promotions share.

-   **[Unbundled Promotions: A Deeper Look](https://developer.salesforce.com/docs/platform/devops-center-dev/guide/devops-center-dev-promotions-unbundled.md)**  


    Now that we know the main custom objects involved in an unbundled promotion, let’s step through the different phases of the promotion and check the status of these objects at each phase.