---
title: Rolling back a promotion (early access)
description: Roll back a promotion to reset the target environment back to the state it was in immediately prior to the promotion.
component: pingone
page_id: pingone:early-access-features:ea-p1_promotion_rolling_back
canonical_url: https://docs.pingidentity.com/pingone/early-access-features/ea-p1_promotion_rolling_back.html
revdate: February 23, 2026
section_ids:
  limitations-and-considerations: Limitations and considerations
  steps: Steps
  result: Result
  verifying-the-rollback: Verifying the rollback
  steps-2: Steps
  result-2: Result
---

# Rolling back a promotion (early access)

If a promotion causes issues in your target environment, you can roll it back, which restores the environment to its state immediately before the promotion. You can roll back both successful and failed promotions. A rollback undoes all changes made by the promotion.

## Limitations and considerations

* You can roll back only the most recent promotion to the target environment, and all promoted resources are rolled back. You can't select a subset of resources to roll back. You also can't roll back a rollback.

* A promotion can sometimes affect resources that weren't part of the promotion plan. For example, if you promote the deletion of a policy that was assigned to an application, the promotion also deletes the association between the application and the policy in the target environment. To restore the target environment to its previous state, a rollback must not only restore the deleted policy, but also restore the association between the policy and the application. In this case, the application is considered an indirectly affected resource, and is included in the rollback.

* If you make manual changes to promoted resources in the target environment after the initial promotion and before the rollback, those changes might be overwritten during the rollback.

## Steps

1. In the PingOne admin console for your source environment, go to **Promote > Promotions**.

2. In the list of promotions, locate the most recent promotion, click the **More Options** (⋮) icon, and select **Roll Back**.

3. On the **Review Rollback** page, review the summary and add release notes.

   ![A screen capture of the Review Rollback page showing the Rollback tab and listing two resources that will be rolled back.](_images/p1-promote-review-rollback-rollback.png)

4. (Optional) To review the details of the promotion you are rolling back, click the **Previous Promotion** tab.

   This tab shows details about the configuration resources that were promoted and will be rolled back, including any dependencies.

   ![A screen capture of the Review Rollback page showing the Previous Promotion tab with details about the promotion that is being rolled back.](_images/p1-review-rollback-previous-promotion.png)

5. Click **Roll Back Promotion**.

### Result

You're returned to the **Promotions** page. The rollback shows a status of **In Progress**. After a couple of minutes, refresh the page. The status changes to **Success** for a successful rollback.

The promotion you rolled back now shows a status of **Rolled Back**.

![A screenshot of the Promotions list showing a promotion with a status of Rolled Back and a rollback with a status of Success.](_images/p1-promotions-list-showing-rollback.png)

## Verifying the rollback

To verify the results of the rollback, first confirm the details of the rollback in the source environment, then check the target environment and ensure that it matches what you expect.

### Steps

1. In the PingOne admin console for your source environment, go to **Promote > Promotions**.

2. Locate the rollback in the list, click the **More Options** icon (⋮), and select **View**.

   * Overview tab

     The **Overview** tab shows information about when the rollback was started and completed, the source and target environments, the status of the rollback, and any release notes that were added.

     ![A screenshot of the Rollback tab of the rollback details panel.](_images/p1-promote-rollback-details-overview-tab.png)

   * Rolled Back Resources tab

     The **Rolled Back Resources** tab shows the details about the resources that were rolled back.

     ![A screen capture of the Rolled Back Resources tab of the rollback details panel showing the resources that were included in the promotion that you rolled back.](_images/p1-review-rollback-previous-promotion.png)

3. On the **Overview** tab, click the link to the target environment in the **Original Promotion Environment** field.

### Result

You're taken to the PingOne admin console for the target environment so that you can confirm that the results of the rollback match what you expect.