Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Metadata Coverage Report entry
How-to guide

Use the Metadata Coverage Report in a deployment plan

The report is a reference tool. Build it into the standard pre-deployment workflow; it surfaces problems before they cause deploy failures.

By Dipojjal Chakrabarti · Founder & Editor, Salesforce DictionaryLast updated May 21, 2026

The report is a reference tool. Build it into the standard pre-deployment workflow; it surfaces problems before they cause deploy failures.

  1. Open the report

    Navigate to developer.salesforce.com/docs/metadata-coverage. Bookmark it; you''ll reference it often.

  2. List the components in your deployment

    Inventory the metadata components in the change set or SFDX manifest. Group by type for easier matrix lookup.

  3. Check each type''s support level

    Find each component type in the report. Note green checks (proceed), yellow caveats (read the details), red X (manual configuration needed).

  4. Document partial-support caveats

    Yellow-status components often have specific limitations (some fields don''t deploy, certain settings reset). Document these per component in the deployment plan.

  5. Plan manual configuration for unsupported items

    Components with no API support need post-deploy manual configuration. Build the steps into the deployment runbook.

  6. Validate with a pilot deployment

    Test the deployment against a non-production target. Real-world results often reveal additional caveats the report does not document.

Gotchas
  • The report updates per release. Bookmarked links work, but the content changes; re-check before major migrations.
  • Yellow partial-support is the most dangerous status. The component deploys but with subtle gaps; read the caveats carefully.
  • The feedback mechanism really works. Filing requests for unsupported components sometimes accelerates Salesforce''s prioritization.
  • Some components are deployable but require specific permissions in the target org. The report calls these out where applicable.

See the full Metadata Coverage Report entry

Metadata Coverage Report includes the definition, worked example, deep dive, related terms, and a quiz.