Run a Validate-Only Deployment

Run a validate-only deployment to check whether a promotion succeeds without saving metadata to the target org or finalizing the merge into the target stage branch. If the validation succeeds and remains eligible, complete promotion within 10 days to deploy the validated changes without rerunning Apex tests.

Required Editions

Available in: Lightning Experience in Professional (API access required), Enterprise, Performance, Unlimited, and Developer Editions
Not available in: Government Cloud Plus. Contact your Salesforce account executive for more details.
Not available in: EU Operating Zone. EU Operating zone is a special paid offering that provides an enhanced level of data residency commitment. Lifecycle Center is supported in orgs in the EU that aren’t part of EU OZ, per standard product terms and conditions.
User Permissions Needed
To run a validate-only deployment: Lifecycle Center Deployment Manager

You can complete the promotion from a validation only if:

  • The deployment checks and selected tests pass.
  • The changes meet code coverage requirements.
  • The validation remains current.

Review the considerations before you start. See Validate-Only Deployment.

  1. Go to the Pipelines tab and select your pipeline.
  2. On a pipeline stage, click Promote Stage.
  3. In the Promotion Options window, select Validate only.
  4. Select the changes to validate.
  5. Select a test option.
    To promote the changes later without rerunning tests, select a non-default test option. The tests must pass, and your changes must meet the code coverage requirements.
  6. Click Promote.
    Lifecycle Center checks the deployment without saving changes to the target org or finalizing the branch merge. The validation result appears in Activity History. If the validation fails, review the activity details, correct the issues, and run another validation.

To complete the promotion without rerunning Apex tests, click Complete Promotion in your pipeline stage within 10 days. This option is available only while the validation remains eligible and the changes selected for the promotion match the validated changes. If the option is unavailable, run another validation or use a standard promotion.