Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Collapsible Section entry
How-to guide

How to use Collapsible Sections to make dense pages usable

The pattern: identify low-frequency sections, set them default-collapsed, leave high-frequency sections default-expanded, watch usage. The cost is minimal; the readability gain is meaningful for any page with more than 5 to 7 sections.

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

The pattern: identify low-frequency sections, set them default-collapsed, leave high-frequency sections default-expanded, watch usage. The cost is minimal; the readability gain is meaningful for any page with more than 5 to 7 sections.

  1. List the sections on the page

    Open the Lightning Record Page in App Builder. Count the sections. Pages with fewer than 5 sections probably do not need collapsible defaults; pages with 8+ sections benefit a lot.

  2. Identify the high-frequency sections users always need

    The top one or two sections (Account Information, Opportunity Details) usually stay default-expanded. Everything else is candidate for default-collapsed.

  3. Mark low-frequency sections as default-collapsed

    Click into each section, toggle Default Collapsed. System Information, Audit Fields, archival sections are typical candidates.

  4. Pair with conditional visibility where applicable

    Sections that should only appear under specific conditions get conditional visibility instead of (or in addition to) collapsible. Cleaner than collapsing always-irrelevant sections.

  5. Test on mobile viewport

    Open the page on a phone-sized window or actual mobile device. Confirm the default-collapsed state matches what mobile users want to see first.

  6. Publish and gather feedback

    Activate the page. Watch for user complaints about hidden information; the defaults are the admin's hypothesis and users will tell you if you got it wrong.

  7. Refine quarterly based on usage signals

    Lightning Usage Reports show which components users interact with most. Sections users always expand should become default-expanded; sections users never expand should be considered for conditional visibility or removal.

Key options
Default expanded/collapsed stateremember

Per-section setting; the admin's hypothesis about what most users want to see on load.

Conditional visibilityremember

Show or hide entire sections based on field values. Better than collapsible for always-or-never information.

Accordion vs Tabs vs Collapsibleremember

Three information-density patterns. Pick based on the user workflow.

Mobile-specific layoutremember

Mobile users see the same collapsible defaults unless a separate mobile page is built. Most teams use one shared layout.

Per-user persistenceremember

Collapse state persists per user per section. Users control their own view across visits.

Gotchas
  • Over-using default-collapsed hides information users need on every visit. Reps complain about repeated expansion clicks; recalibrate based on real usage.
  • Collapsed sections still render in the DOM. Performance-sensitive pages should use conditional visibility for heavy components, not just collapse.
  • Default state applies only to users who have not personally adjusted. Tenured users keep their settings; admin defaults shift only for new or unchanged users.
  • Mobile and desktop share the same collapsible defaults unless separate mobile pages are built. A default that works on desktop may feel busy on mobile.
  • Collapsible is sometimes used as a substitute for proper page design. Pages with too many sections need restructuring, not just collapsing.

See the full Collapsible Section entry

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