---
schema_version: "1"
id: 26e963382547b822450a130615cadac6d75d6e80d9d84e88275ac2e5b2ca655e
title: On-Demand Testing for Pre-Promotion Events
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/devops_center_testing_on_demand_pre_promotion.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.devops_center_testing_on_demand_pre_promotion.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: c47fa3dded11251563b09b176adfc1c0c77c0368642037acb21361dfe7a960f3
description: If a Pre-Promotion Event fails, on-demand testing lets you manually verify whether tests are now passing. A new automated execution runs when the promotion is attempted again. This is most commonly used when a promotion is blocked by a failed quality gate and you need to re-trigger testing after resolving the underlying issue.
products:
  - Salesforce Platform
release: "264"
---
# On-Demand Testing for Pre-Promotion Events

If a Pre-Promotion Event fails, on-demand testing lets you manually verify whether tests are now passing. A new automated execution runs when the promotion is attempted again. This is most commonly used when a promotion is blocked by a failed quality gate and you need to re-trigger testing after resolving the underlying issue.

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

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d7442e106">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d7442e106 ">To run on-demand testing for pre-promotion events:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d7442e106 ">Lifecycle Center Testing Manager OR Lifecycle Center User OR Lifecycle Center Deployment
              Manager</td>

          </tr>
        </tbody>
      </table>

Before you begin, make sure that the test suites are assigned to the destination stage. See [Add Test Suites to a Stage](https://help.salesforce.com/s/articleView?id=platform.devops_center_testing_add_test_suites_to_stage.htm&release=264.0.0&type=5 "Assign test suites to a pipeline stage to automate quality checks when a Review Event or Pre-Promotion Event is triggered for that stage.").

![Test Results modal showing test suites with Quality Gate, Tests Passed, Test Execution Status, and Quality Gate Status columns, with View Detail and New Run buttons](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-devops_center-264-0-0-production-enus/166010c3-4c34-4087-92ad-aea917baf524/devops_center/images/devops_center_testing_on_demand_pre_promotion.png)

1. From the Lifecycle Center navigation menu, select the **Pipelines** tab.
2. Locate the pipeline stage — such as Integration or Staging — that contains the work items.
3. Trigger test execution based on your situation.
    - For a first run or manual run, click **Run Test** associated with the promotion in the stage card.
    - After a failed pre-promotion event, click **Test Results** in the action menu of the stage card. Click **New Run**.

Once the test run completes, review the results. If all quality gate criteria are met, proceed with the promotion. If tests fail again, review the failure details and resolve the issues before rerunning.

![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 Each pipeline stage — Integration, Staging, and Production — can have different test suites and quality gate rules assigned. Make sure that the correct suites are assigned to the target stage before running tests manually. See [Add Test Suites to a Stage](https://help.salesforce.com/s/articleView?id=platform.devops_center_testing_add_test_suites_to_stage.htm&release=264.0.0&type=5 "Assign test suites to a pipeline stage to automate quality checks when a Review Event or Pre-Promotion Event is triggered for that stage.").

#### See Also

- [View Test Details for Pre-Promotion Events](https://help.salesforce.com/s/articleView?id=platform.devops_center_testing_view_test_details_pre_promotion.htm&release=264.0.0&type=5 "Review the test results generated by a pre-promotion test run to assess whether a work item meets quality gate requirements before it advances to the next pipeline stage.")