Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Deployment Status entry
How-to guide

How to set up Deployment Status in Salesforce

Deployment Status is the read-only monitoring page for in-flight and recent metadata deployments — Change Sets, Salesforce DX deploys, Apex packages. When a deployment fails, this is where you find the error message and decide whether to roll back.

By Dipojjal Chakrabarti · Editor, Salesforce DictionaryLast updated Apr 20, 2026

Deployment Status is the read-only monitoring page for in-flight and recent metadata deployments — Change Sets, Salesforce DX deploys, Apex packages. When a deployment fails, this is where you find the error message and decide whether to roll back.

  1. Open Setup → Deployment Status

    Setup gear → Quick Find: Deployment Status → Deployment Status.

  2. Review in-flight deployments

    Top of the page — Pending and In Progress deployments. Each shows progress percentage and elapsed time.

  3. Review recent deployments

    Below — Succeeded, Failed, and Rolled-Back deployments from the last X days. Each is clickable.

  4. Click a deployment for details

    Test results, component-by-component success / fail, error messages.

  5. For failures: read the error and fix the source

    Errors are usually missing dependencies or test-coverage gaps. Fix in source, re-deploy.

  6. For successful but problematic deploys: rollback or re-deploy

    Salesforce supports Quick Deploy of validated deploys. To roll back, deploy the previous version's metadata.

Key options
In Progress / Pending / Succeeded / Failed / Rolled Backremember

Status filters.

Test Resultsremember

Per-class test pass / fail. Drill in to see which tests failed.

Component Resultsremember

Per-metadata-component success / fail.

Quick Deployremember

Re-deploy a previously-validated deployment without re-running tests.

Gotchas
  • Failed deployments show the error message but the fix is in the source — Setup → Deployment Status doesn't let you edit. Fix in your deployment source (Change Set / DX project) and re-deploy.
  • Test coverage failures block production deploys. Salesforce requires ≥75% coverage on changed Apex; a deployment that adds untested code fails even if the code itself is valid.
  • Quick Deploy requires the validation to be recent — within 4 days. Older validations require re-running tests.

See the full Deployment Status entry

Deployment Status includes the definition, worked example, deep dive, related terms, and a quiz.