How To Change Lightning Record Page Template In Salesforce

How To Change Lightning Record Page Template In Salesforce

How to Add Salesforce Reports and Dashboards on Lightning Pages ...

Changing a Salesforce Lightning record page template allows administrators to reorganize component layouts, optimize user visibility for specific business units, and transition legacy desktop interfaces into dynamic, responsive layouts. Mastering this process requires navigating the Lightning App Builder, managing component visibility rules, and deploying updates safely through custom activation profiles.


Pre-Procedure Planning for Salesforce Layout Adjustments

Modifying a production-level Lightning record page requires careful planning to prevent workflow disruption, broken component configurations, and user friction. Administrators must verify their administrative permissions, identify the target object context, and establish a clear rollout strategy before altering structural templates.



  • Essential Tools & Access: System Administrator or Customize Application permissions, access to Lightning App Builder, and a dedicated Sandbox environment for testing deployments.
  • Prerequisite Knowledge & Standards: Familiarity with Lightning Component Framework, record page architecture, dynamic forms compatibility, and profile-based or app-based assignment hierarchies.
  • Estimated Duration & Benchmarks: 15 to 30 minutes for standard template migration; allow up to 2 hours if custom dynamic visibility filters and component refactoring are required.

Step-by-Step Lightning Record Page Template Modification



Step 1: Access the Target Lightning Record Page in App Builder

Navigate to the specific object record page you intend to modify within your Salesforce org. Click the gear icon in the global header and select Edit Page to launch the Lightning App Builder directly in the context of that record. Alternatively, navigate to Setup, open the Lightning App Builder, locate your target page in the list of custom pages, and click Edit. Ensure you are working on the correct master or cloned version of the page depending on whether you are applying changes globally or targeting specific app-record combinations.

Pro-Tip: Always clone an existing production page rather than editing the default system template directly. This preserves a safe rollback option if user acceptance testing reveals configuration errors.



Step 2: Change the Page Template Structure

In the left-hand properties pane of the Lightning App Builder interface, locate the template section and click the Change button next to the current template name. A modal window will appear displaying all available standard and custom structural options, including single-region layouts, header-with-sidebar configurations, and multi-column grid templates. Select your desired new template structure, such as a three-column layout or a header and two-column layout, and click Next.

Warning: Changing a template layout that contains existing components in deleted regions will automatically move those components into an unassigned region section. You must manually drag and drop them into the new template regions to restore visibility.



Step 3: Reallocate and Configure Existing Components

Review the structural regions of your newly selected template to ensure all essential components—such as Highlights Panel, Details tab, Related Lists, and custom Lightning Web Components—are correctly positioned. Drag components from their temporary holding areas into the primary and secondary regions of the new template. Check the component properties pane for each item to verify that visibility rules, filter conditions, and record type associations remain intact after the structural shift.



Step 4: Save, Validate, and Activate the Page

Click the Save button in the top-right corner of the Lightning App Builder. If this is your first time saving a newly cloned page, the activation wizard will prompt you to define the assignment parameters. Assign the page as the org default, app default, or by specific combinations of apps, record types, and user profiles. Review your assignment summary to prevent conflicts with legacy flexi-pages, then click Finish and exit back to the live record view to test responsiveness.


Add Report Chart to Lightning Record Page - Automation Champion

Add Report Chart to Lightning Record Page - Automation Champion

Salesforce Page Template Comparison Matrix



Template Type Primary Use Case Region Capacity Recommended Component Types
Header and Two-Column Standard sales and service record management Header, Main Column, Sidebar Highlights Panel, Details, Chatter, Activities
Three-Column Layout Data-dense dashboards and analytics-heavy records Header, Left Sidebar, Center Main, Right Sidebar Reports, Metrics, List Views, Core Fields
Single Region (One Column) Mobile-first layouts and focused task execution Single Full-Width Region Custom LWC, Dynamic Forms, Guided Flows
Two-Column Equal Width Side-by-side comparison or approval workflows Header, Left Main, Right Main Approvals, Related Lists, Audit Logs

Common Page Configuration Failures and Field Fixes



  • Component Disappearance Post-Migration:

    • Root Cause: Switching to a template with fewer regions causes Salesforce to dump overflow components into unassigned containers.
    • Actionable Fix: Re-enter the Lightning App Builder, locate the unassigned components section at the bottom of the canvas, and drag them into active template regions.
  • Activation Conflicts Across Profiles:

    • Root Cause: Overlapping assignment criteria where multiple record pages target the same app and profile combination.
    • Actionable Fix: Open the Activation menu in App Builder, review assignment precedence, and assign specific record types or user profiles to distinct pages.
  • Broken Dynamic Forms Field Visibility:

    • Root Cause: Moving from a traditional page layout component to a region-based dynamic form without validating field-level security or filter logic.
    • Actionable Fix: Inspect individual field section properties in the builder and re-apply conditional visibility filters based on record field values.

Frequently Asked Questions



Can I convert a standard record page template into a custom Lightning Web Component template?

Standard Salesforce templates provided in the Lightning App Builder cannot be converted directly into custom code, but you can build custom Lightning Web Components designed with specific CSS grids and slots to act as custom templates. These custom templates can then be registered for use within the Lightning App Builder interface.



What happens to my custom components when I switch templates?

When you change a template, Salesforce retains all existing components and places any components from deleted regions into an unassigned pool at the bottom of the page properties pane. You will not lose component configurations, but you must manually place them into valid regions in the new layout.



How do record types affect Lightning record page templates?

Record types allow you to assign completely different Lightning page templates and component configurations to the same object based on the specific business process or user profile. During the activation phase of changing a template, you can scope your changes exclusively to selected record types.



Can I revert to a previous version of a Lightning record page?

Salesforce does not maintain a built-in historical version control rollback for Lightning record pages within the App Builder interface. To safeguard your work, always clone pages before major structural overhauls or maintain unmanaged package backups in a version-controlled repository.



Why is the Change button disabled for my record page template?

The Change button may be locked if you are attempting to modify a managed package page installed from AppExchange or if your user profile lacks sufficient administrative customization privileges. You must clone the managed page or elevate your permissions to modify structural templates.

Optimize your Salesforce architecture today by standardizing your record page templates to drive user adoption and streamline daily data entry workflows.


Getting Started with Lightning Components and Record Pages - Admin Hero

Getting Started with Lightning Components and Record Pages - Admin Hero

Read also: How UNION BULLETIN WALLA WALLA uncovered the city budget mystery