All docs pages (49)
Org Compare
Compare the objects and fields of two Salesforce orgs you are signed in to, and see what exists in only one org or differs between them.
Updated 2026-11-09
Org Compare shows the schema differences between two Salesforce orgs: which objects exist in only one of them, and for an object in both, which fields are missing or differ. It is useful before a deployment or a data migration between a sandbox and production. Open Metadata → Org Compare.
How to use it
- Sign in to both orgs in your browser. The Org A and Org B lists show the orgs where your Salesforce session is still live. Sandboxes are marked (sandbox).
- Pick one org in Org A and a different one in Org B. The swap button between them exchanges the two.
- Click Compare objects.
- Use the filter chips to choose what to show: Differences (the default), All, Only A, Only B, Changed or Same.
- Click an object that exists in both orgs to compare its fields. Click Back to objects to return.
- Click Export CSV on the object list, or Export on the field list, to download the rows the current filter shows.
If fewer than two orgs are available, the page says Connect a second org. Open the other org in a browser tab and click Refresh orgs.
What you see
Objects. Counts for Only in A, Only in B, Changed and Same, then a table with each object's API name, label and status. An object is Changed when its label differs between the orgs; Org Compare compares nothing else at the object level. Objects are matched by API name, ignoring upper and lower case.
Fields. For the chosen object, a table with each field's API name, its status, its type and length in each org, and a Changes column. A field is Changed when any of these differ:
- type
- length
- nillable (whether the field can be blank)
- unique
- referenceTo (the objects a lookup points to)
- picklist values (the API values, in any order)
Each change shows the Org A value and the Org B value, for example length: 80 → 255. Field labels, help text, descriptions and formulas are not compared.
What it reads and writes
Org Compare only reads. For each org it calls the REST describe endpoints with that org's own session: the global describe (/sobjects) for the object list, and the object describe (/sobjects/<Object>/describe) when you open an object. It does not change anything in either org.
Limits
- It compares schema from describe calls only. Flows, Apex, layouts, permission sets and other metadata are not compared.
- Describe returns what your user can see in each org, so different users or permissions in the two orgs can show up as differences.
- Only objects that exist in both orgs can be opened for a field comparison.
- Both orgs need a live session in the browser. An org you have signed out of doesn't appear in the lists.
- Changing either org, or swapping them, clears the current results.