How to Retrieve Salesforce Metadata Without the CLI
Retrieve Salesforce metadata - objects, fields, layouts, profiles - using the Metadata API, the CLI, or an in-browser viewer, and when each is worth the setup.
Updated 2026-09-09
Metadata answers the questions data cannot: which fields exist, how they are defined, what they are called in the API, and what depends on them.
There are three routes, and the fastest one depends on whether you need an artifact you can diff or an answer you need right now.
Option 1 - Salesforce CLI
sf project retrieve start --metadata CustomObject:Account --target-org my-orgsf project retrieve startpulls metadata into a local project you can diff and commit.- Best for deployments, code review, and anything that must move between orgs.
- Requires an authenticated org and a local project - overkill for a single lookup.
Option 2 - the Metadata and Tooling APIs
The Tooling API answers field- and object-level questions directly, and it is queryable with SOQL-like syntax. This is the route to script when you want a report of every field on every object.
SELECT QualifiedApiName, DataType, Label
FROM EntityParticle
WHERE EntityDefinition.QualifiedApiName = 'Account'Option 3 - read it in the browser
For the common case - what is this field's API name, type, and help text - TurboKit's metadata retriever shows field-level details inline on the record page, without a project, a CLI, or a second tab.
What to check metadata for
- API names before writing SOQL or an integration mapping.
- Field types and lengths before an import.
- Dependencies before deleting a field - formulas, layouts, and validation rules that reference it.
Frequently asked questions
- What is the difference between the Metadata API and the Tooling API?
- The Metadata API deploys and retrieves configuration as files, and it is built for migrations. The Tooling API queries and modifies individual metadata records, which suits inspection and lightweight edits.
- Do I need a developer setup to read metadata?
- Not for reading. Setup and browser tools cover inspection. The CLI matters when you need version-controlled artifacts or a repeatable deployment.
- Why does a field exist in the API but not in Setup search?
- Setup search matches labels, and the API name can differ from the label entirely. Search by the label, and confirm the API name from the field definition.
More from the Admin How-To
- How to Check Field-Level Security in Salesforce FastCheck field-level security in Salesforce without clicking through Setup: where FLS lives, how it interacts with profiles and permission sets, and faster ways to read it.
- How to Compare Two Profiles in SalesforceCompare two Salesforce profiles field by field: the native Setup route, the permission types worth diffing, and how to keep the result auditable.
- How to Create Multiple Custom Fields in Salesforce QuicklyCreate custom fields in Salesforce in bulk - the Setup wizard, metadata deployment, and in-browser field creation - plus the naming rules to settle first.
- Change Sets vs Metadata API Deployments: Which to UseChange sets and Metadata API / CLI deployments solve the same problem differently. Here is when each one is the right choice, and what a change set genuinely cannot do.
- How to Check Salesforce Org LimitsCheck Salesforce org limits - API calls, data storage, file storage, and daily email - from Setup, the limits API, and the browser, before you hit them.
- How to Create and Deploy a Salesforce Change SetStep by step: create an outbound change set, upload it, and deploy it as an inbound change set - plus the deployment connection you need between orgs before any of it works.
Related reading
- SOQL LibrarySOQL Query for Accounts Modified TodaySOQL for accounts changed today, including LastModifiedBy, audit-field filters, and how to spot integration-driven updates.
- SOQL LibrarySOQL Query for Campaigns Modified TodaySOQL for campaigns changed today, including LastModifiedBy, audit-field filters, and how to spot integration-driven updates.
- SOQL LibrarySOQL Query for Cases Modified TodaySOQL for cases changed today, including LastModifiedBy, audit-field filters, and how to spot integration-driven updates.
- SOQL LibrarySOQL Query for Contacts Modified TodaySOQL for contacts changed today, including LastModifiedBy, audit-field filters, and how to spot integration-driven updates.