Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Record Detail Page entry
How-to guide

Customize a record detail page in the Lightning App Builder

Customize the record detail body of a Lightning record page in the Lightning App Builder, then activate it for the right users.

By Dipojjal Chakrabarti · Founder & Editor, Salesforce DictionaryLast updated Jun 16, 2026

Customize the record detail body of a Lightning record page in the Lightning App Builder, then activate it for the right users.

  1. Open the record page editor

    From a record, click the gear icon and choose Edit Page, or go to Setup and open the Lightning App Builder for the object. This opens the canvas where the Record Detail component lives.

  2. Select the Record Detail component

    Click the Record Detail block on the canvas. To control fields directly, choose the option to upgrade the page to Dynamic Forms, which converts the single block into Field and Field Section components.

  3. Arrange fields and sections

    With Dynamic Forms on, drag field sections into columns or onto tabs, reorder fields, and add new fields from the Fields tab in the component palette without touching the page layout editor.

  4. Add visibility rules

    Select a field or section, open Set Component Visibility, and add filters based on record values, the running user, or device form factor so the right people see the right detail.

  5. Activate and assign

    Click Activation, then set the page as the org default or assign it to an app, record type, and profile combination. Preview across desktop and phone form factors before saving.

Key options
Record Detail componentremember

The standard component that renders the full page layout fields and field sections for the record.

Upgrade to Dynamic Formsremember

Converts the monolithic Record Detail into individual Field and Field Section components managed in the App Builder.

Set Component Visibilityremember

Filters that show or hide a field, section, or component based on record data, user, or form factor.

Activation assignmentremember

Controls whether the page is the org default or scoped to an app, record type, and profile.

Gotchas
  • The plain Record Detail component has no way to add a single field. Edit the page layout or upgrade to Dynamic Forms instead.
  • Fields on the Details tab can look missing if you forget the page uses a Tabs component. Check the other tabs first.
  • The Highlights Panel reads from the compact layout, not the Record Detail, so summary fields are configured in a different place.
  • The most specific activation wins. An app, record type, and profile assignment overrides the org default for those users.

See the full Record Detail Page entry

Record Detail Page includes the definition, worked example, deep dive, related terms, and a quiz.