Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Layout entry
How-to guide

Configure layouts for a record page

Configuring layouts spans Page Layouts, Lightning Pages, and assignments. The steps below cover the typical setup for a new object or significant page redesign.

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

Configuring layouts spans Page Layouts, Lightning Pages, and assignments. The steps below cover the typical setup for a new object or significant page redesign.

  1. Design the page structure

    Sketch what users need to see and do on the record page. Decide which fields are primary (Highlights), which are secondary (form), and which are related list scope.

  2. Configure Page Layout

    Object Manager > Object > Page Layouts. Edit the relevant layout. Organize fields into sections; set Read-Only and Required flags. Configure related lists.

  3. Configure Compact Layout

    Object Manager > Object > Compact Layouts. Edit the primary Compact Layout to show the most important fields in the Highlights panel.

  4. Build Lightning Page

    App Builder. Build the Lightning Page with the components users need (Record Detail, Activity, Files, related lists, custom components). Save and activate.

  5. Assign layouts to profiles

    Object Manager > Object > Page Layouts > Page Layout Assignment. For each profile, assign the appropriate Page Layout for each record type.

  6. Configure Search Layouts

    Object Manager > Object > Search Layouts. Set columns for list views, search results, and lookup dialogs.

  7. Test from a sample user

    Use Login As to impersonate a target user. Confirm the record page displays as expected; verify Highlights, Form, related lists, search results.

Key options
Page Layout (classic)remember

Field placement for the form. Coexists with Lightning Page.

Lightning Pageremember

Overall page structure including components beyond fields.

Compact Layoutremember

Drives the Highlights panel and mobile.

Search Layoutremember

Controls list views, search results, and lookups.

Dynamic Formsremember

Modern Lightning-native alternative to classic Page Layouts.

Gotchas
  • Page Layout and Lightning Page coexist; both need configuration in modern orgs. Configuring only one produces an incomplete user experience.
  • Layout assignment is per profile per record type. The assignment matrix grows with both factors; large orgs need disciplined management.
  • Compact Layout drives the Highlights panel separately from Page Layout. Forgetting to configure Compact Layout produces a sparse or confusing Highlights area.
  • Search Layouts are configured separately. Poor Search Layouts force users to open records to find information that could appear in list views.
  • Layouts are deployable metadata. Direct production edits bypass change management and can introduce regressions; deploy through changesets or SFDX.

See the full Layout entry

Layout includes the definition, worked example, deep dive, related terms, and a quiz.