Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Custom Report Type entry
How-to guide

How to set up Custom Report Type in Salesforce

Custom Report Types let you build reports across object combinations Salesforce doesn't ship as standard — "Accounts with Cases AND with Opportunities," "Custom Object A with related Custom Object B with related Account." Define the object relationships once; report builders use them as templates.

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

Custom Report Types let you build reports across object combinations Salesforce doesn't ship as standard — "Accounts with Cases AND with Opportunities," "Custom Object A with related Custom Object B with related Account." Define the object relationships once; report builders use them as templates.

  1. Open Setup → Report Types

    Setup gear → Quick Find: Report Types → Report Types.

  2. Click New Custom Report Type

    Top-right of the list.

  3. Pick the Primary Object

    The starting point of the report. All other objects are related-via.

  4. Set Report Type Label, Name, Description, Category

    Category drives where the report type appears in the New Report picker.

  5. Pick Deployment Status: In Development / Deployed

    In Development = only admins can use. Deployed = visible to all profiles per their permissions. Stage in Development first, then flip.

  6. Save → click Edit Layout to add related objects

    Up to 4 levels deep of related objects. Each level: "With X" / "With or Without X." "With or Without" includes orphan parents.

  7. Drag fields from each object onto the field layout

    Only fields you drag into the layout are available to report builders. Default fields are pre-included — drag custom ones.

  8. Save

    Report Type is now available. Builders can pick it via New Report → Custom Report Types.

Key options
Primary Objectremember

Starting object. Locked after Save.

Related Objects (up to 4 levels)remember

With X / With or Without X. Drives joins.

Deployment Statusremember

In Development (admin-only) / Deployed (everyone).

Field Layoutremember

Which fields are exposed. Drag-and-drop.

Gotchas
  • Primary Object is locked after Save. To change the report type's starting object, you must recreate.
  • "With or Without" related objects make the join an outer join. Reports can show parents with no related records — easy to misread ("why are these Accounts showing zero Opps?").
  • Field Layout exposure is the gate for what report builders can include. A field exists in Object Manager but isn't on the report layout — builders can't add it. Add fields to the layout when first creating the report type.

See the full Custom Report Type entry

Custom Report Type includes the definition, worked example, deep dive, related terms, and a quiz.