Configuring promotion concurrency

Queue or terminate releases for concurrent product promotions

Promotion concurrency for products

When multiple promotions are triggered for a product, multiple releases can occur at the same time or concurrently.
Promotion concurrency defines how these promotions are handled to ensure a structured, controlled process instead of overlapping or conflicting deployments. By managing concurrency per product, teams can prevent deployment conflicts, reduce rollback risks, and maintain stability, aligning with Software Development Life Cycle (SDLC) best practices.

Why use promotion concurrency?
  • Improved reliability
    Ensures that each release completes before the next one begins, preventing conflicts and incomplete deployments.
  • Operational consistency
    Ensures that ongoing releases are not abruptly terminated, preserving deployment stability.
Where can you configure promotion concurrency for products?

In Product > Settings > Promotion Concurrency.

Configure promotion concurrency behavior in Product Settings

Configure promotion concurrency behavior in Product Settings

How promotion concurrency works

When a promotion starts for a product, it follows one of two concurrency policies:

Queue releases (default)

With this policy, new releases are queued and wait until the ongoing release completes execution.

  • If a release is already in progress, the new release enters a QUEUED state.
  • The new release starts automatically once all previous releases reach a final state: successful, failed, terminated, or error.
  • The default predefined queue limit for pending releases is 50 releases, ensuring releases do not accumulate indefinitely.
  • If the release queue exceeds the limit for pending releases, older releases are terminated in order from first to last (configurable).

Terminate releases

The second concurrency policy is to terminate releases. With this policy, when a new release is created, the ongoing release is automatically terminated.
With this policy, only one release is active for a product at any one time.

Assigning applications to products
Configuring promotion flows and triggers for products
Tracking product releases
Configuring Product Settings