Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
DictionaryPPage Layout
AdministrationIntermediate

Page Layout

A Page Layout in Salesforce controls the arrangement of fields, buttons, related lists, and custom links on a record detail page.

Β§ 01

Definition

A Page Layout in Salesforce controls the arrangement of fields, buttons, related lists, and custom links on a record detail page. Administrators use the drag-and-drop layout editor to organize which elements appear, in what order, and whether fields are required, read-only, or hidden for users assigned to specific profiles.

Β§ 02

In plain English

πŸ‘‹ Study buddy

β€œHere's a simple way to think about it: Page Layout is still the foundation of how a record actually looks. Even when Lightning App Builder renders the page, it pulls field arrangement, related lists, required-field rules from the underlying Page Layout.”

Β§ 03

Worked example

scenario Β· real-world use

The admin at VertexPharma creates two Page Layouts for the Case object: one for Tier 1 agents that shows basic fields and a prominent "Escalate" button, and another for Tier 2 agents that includes advanced fields like Root Cause, Engineering Notes, and a related list of linked Jira tickets. Each layout is assigned to the appropriate profile.

Β§ 04

Why Page Layout is still the foundation of how a record actually looks to users

Lightning App Builder, Dynamic Forms, and Lightning Pages get most of the attention in modern Salesforce - but underneath all of them, Page Layout is still where the core decisions about a record live. Which fields appear in the highlights panel? Which related lists show up? What's required, what's read-only, what's hidden by profile? Even when a Lightning Page is doing the rendering, it's pulling that information from a Page Layout assigned to the record's profile.

The reason this page deserves real care is that page layouts are the most visible part of the platform - every user sees one every time they open a record. A messy layout (fields out of logical order, required fields buried, irrelevant related lists at the top) makes the platform feel disorganized and slow even when nothing is technically wrong. Audit layouts the way you'd audit a frequently-visited app screen: per persona, per record stage, with attention to what users actually scan first.

Β§ 05

How to set up Page Layout

Page Layouts control field placement, related lists, and Salesforce Classic-style buttons on a record's Details tab. In Lightning, Lightning Record Pages (built in Lightning App Builder) sit on top β€” but page layouts still drive the Details tab inside them. They're not going away.

  1. Open Setup β†’ Object Manager β†’ [object] β†’ Page Layouts

    Object Manager β†’ object β†’ Page Layouts in the left rail.

  2. Click New (or Clone an existing)

    New gives you a fresh layout. Clone is more common β€” gives you a starting point.

  3. Drag fields and sections from the palette

    Top half of the editor is the palette; bottom half is the layout. Drag-and-drop. Sections can be 1- or 2-column.

  4. Set Field Properties (Required, Read-only)

    Hover a field on the layout β†’ wrench icon β†’ Required / Read-only toggles. These apply on this layout only β€” not at the API level.

  5. Configure Related Lists

    Related Lists section in the palette β†’ drag in. Click the wrench on each related list to pick which columns show + sort order + buttons.

  6. Configure Mobile & Lightning Actions and Quick Actions

    Drag from the Salesforce Mobile and Lightning Experience Actions section. These are what appears in the Activity composer / Highlights panel.

  7. Save β†’ Page Layout Assignment

    Save the layout. Then click Page Layout Assignment to map Profile Γ— Record Type β†’ this layout.

Key options
Sectionsremember

1- or 2-column. Drag fields in. Section headers are visible to users.

Field Propertiesremember

Required and Read-only toggles per field, per layout.

Related Listsremember

Which child objects show, in what columns, with what buttons.

Highlights Panelremember

Up to 7 fields shown at the top of the Lightning record page (configured via the Lightning Compact Layout or Lightning Page on most modern orgs).

Mobile & Lightning Actionsremember

Which quick actions appear in the activity composer.

Page Layout Assignmentremember

Which Profile Γ— Record Type combos see this layout.

Gotchas
  • Required on a Page Layout is NOT required at the API level. A Validation Rule or a Custom Field with "Required" ticked at the field-definition level enforces across UI + API.
  • In Lightning, Lightning Record Pages override layouts for everything except the Details tab. If you can't figure out why a button isn't showing, check the Lightning Page in Lightning App Builder, not just the Page Layout.
  • Page Layout Assignment is per Profile Γ— Record Type. Forget the Record Type axis and users with the wrong record type see the wrong layout.
Β§ 06

How organizations use Page Layout

Vanguard Solutions

Per-profile Page Layouts let sales and service teams see the same Account differently; each role gets the fields and related lists they need.

BlueRiver Health

Patient page layouts vary by care plan stage; Dynamic Forms layered on top surface fields conditionally.

Atlas Manufacturing

Service Console layouts strip non-essential fields for agents; full-detail layouts reserved for power users.

Β§

Trust & references

Official documentation

Straight from the source - Salesforce's reference material on Page Layout.

Was this entry helpful?
Help us write better definitions. Quick reactions or detailed edit suggestions.
Β§

Test your knowledge

Q1. Can a Salesforce admin configure Page Layout without writing code?

Q2. What is the primary benefit of Page Layout for Salesforce administrators?

Q3. Why is understanding Page Layout important for Salesforce admins?

Β§

Discussion

Loading…

Loading discussion…