Skip to main content

Grow your business with Salesforce Starter

Deepen customer relationships with sales, service, and marketing in one app.

Start your free 30-day trial
Time Estimate

Get Started With Dynamic Forms

Learning Objectives

After completing this unit, you’ll be able to:

  • Explain the differences between Dynamic Forms-based record pages and standard record pages.
  • List the benefits of Dynamic Forms.
  • Migrate a record page to Dynamic Forms.
  • Explain how Dynamic Forms-based pages are displayed on mobile devices.


This unit requires some additional instructions for screen reader users. To access a detailed screen reader version of this unit, click the link below:

Open Trailhead screen reader instructions.

Before You Start

This unit builds on the record page that you created in the previous unit. Complete the previous unit first and use the same record page to walk through this unit. 

What Is Dynamic Forms?

Dynamic Forms takes the Lightning App Builder to a whole new level. It lets you, the Salesforce admin, build highly flexible and dynamic experiences your users will love by configuring record detail fields and sections inside the Lightning App Builder.

Imagine your Salesforce org today. Maybe it has several slightly different versions of a page to support different profiles or record types. And maybe you have page layouts with 100+ fields because different kinds of users use different fields on the same object. The more fields on your page layout, the more the Record Detail component becomes a monolithic block of fields that you can’t customize. 

Dynamic Forms breaks the Record Detail component on your Lightning pages into individual field and section components that you can put anywhere on the page, including in separate tabs and accordion sections. You can use visibility rules to show your end users only the fields they need to see, when they need to see them. 

Example page in the Lightning App Builder has three field sections with two or more fields in each section

Dynamic Forms gives you: 

  • An instant upgrade from page layouts: Place fields and sections wherever you want.
  • Dynamic layouts: Use visibility rules to show and hide fields and sections.
  • Simpler layout management:
    • Manage the fields and sections on your pages in the Lightning App Builder without touching the page layout editor.
    • Reduce the number of page layouts and record types you need by defining component visibility rules.
    • Assign a Lightning page without having to assign a page layout too.

How Does Dynamic Forms Work?

Dynamic Forms adds a new tab to the component pane: Fields. The Fields tab contains the Field Section component and a list of fields. You can put a Field Section component anywhere on the page, and you can put fields anywhere within a Field Section component.

You can start using Dynamic Forms in two ways.

  • Create a fresh Lightning record page. Then, click the Fields tab in the Lightning App Builder component pane, and start dragging sections and fields anywhere you want them on the page.
  • Open an existing record page and with just a few clicks, migrate its record details using the Dynamic Forms migration wizard.

In this unit, you explore the second option: page migration.


Dynamic Forms (desktop and mobile) is supported for most, but not all standard LWC-enabled objects. See LWC Migration for Record Home Pages for a list of LWC-enabled objects. If you open a record page for an object in the Lightning App Builder and don't see a Fields tab in the component panel, then Dynamic Forms isn't supported for that object. As an example, the Note object doesn’t support Dynamic Forms because it has a fixed layout. Dynamic Forms is not supported on objects that are not LWC-enabled. For example, Campaigns, Products, and Tasks, which are not LWC-enabled, still use information from page layout. 

Migrate a Record Page to Dynamic Forms

With Dynamic Forms, you can migrate the fields and sections from your existing record pages as individual components in the Lightning App Builder. Then configure them just like the rest of the components on the page, and give the users only the fields and sections that they need.

Time to walk through the process.

  1. From Setup, enter App Builder in the Quick Find box, then select Lightning App Builder.
  2. Open the New Opportunity Page you created in the last unit.
  3. Click the Details tab, and then click in the record details.
    This selects the Record Detail component and shows its properties in the properties pane.
  4. In the properties pane, click Upgrade Now to start the Dynamic Forms migration wizard.

Upgrade to Dynamic Forms message with Upgrade Now button

  1. Step through the wizard, select Opportunity Layout, then click Finish.
  2. Click Save.

But wait! Apparently a required field is missing. If you save the page without the required fields, and the missing required fields don’t have values, users can’t save a record after creating, editing, or cloning it.

The Save without required fields message with Save and Cancel buttons

  1. Click Cancel, and figure out what’s missing.
  2. Click the Fields tab in the component palette.

Of the Universally Required Fields, Forecast Category is missing from the Details tab. Why is it missing? When you migrate fields from a layout, if universally required fields for the object weren’t present on the layout you migrated from, they’re not added automatically. (If you peek at the Opportunity Layout page layout, you can see that Forecast Category isn’t on it.)

  1. Click the Details tab, and drag the Forecast Category field into the Opportunity Information section.
  2. Save the page again.

Why choose a page layout in the upgrade wizard when the Fields tab has all the fields you need? You could just drag all those fields manually to the page. But if you choose a page layout instead, then the upgrade wizard takes the fields and sections from that page layout and automatically adds them to your page. Just a few clicks and you’re done!

Here’s the migrated page. Each section is a component, and so is each field inside the section. 

After migration, the Opportunity record Details includes five sections, each containing one or more fields.

The Record Detail - Mobile component has been added to the bottom of the page, and the original Record Detail component has been removed. That’s intentional, and you learn more about it later.


If it looks to you like the fields inside the sections are kind of spread out, you’re not wrong. Density settings for field sections are ignored by the Lightning App Builder preview. Lightning App Builder preview always shows the Comfy setting for field sections. Proper density settings are applied when the page is displayed to your users.

Customize the Page

Even though you broke up the Record Detail into individual field components, there are still quite a few fields on the page, which can cause performance issues. One way to get around that is to move lower priority fields into tabs or accordion sections whose content isn’t visible when the page loads.

Start by optimizingthe page. First, delete the empty Other Information section.

  1. Click the Details tab on the canvas.
  2. Hover over the Other Information section and click Delete to delete it.

Next, add a new tab.

  1. Click the Details tab again.
  2. In the Tabs properties pane, click Add Tab. A new Details tab item appears.
  3. Click the new Details tab item.
  4. In the Tab Label list, select Custom
    You might have to scroll up in the Tab Label list to find Custom at the top.
  5. For Custom Label, enter More Details, then click Done.
  6. In the properties pane, drag the new More Details tab above the Activity tab.


Now, move field sections from Details to More Details.

  1. On the canvas, click the Details tab, and collapse the Opportunity Information section (reducing the vertical space to drag over in the next step).
  2. In the Additional Information section, click Move component and drag the section into the More Details tab.
  3. Do the same for the Description Information section and place it below the Additional Information section.
  4. In the Additional Information section, put the Tracking Number field below Delivery/Installation Status.
  5. Click the Description Information section.
  6. In the Description Information section properties pane, remove the word “Information” from the section label. Granted, this is a pretty small (and boring) change. But with Dynamic Forms, you can name field sections whatever you want. Be creative!

The Additional Information section has five fields in it, but your users don’t really need to see the Main Competitor(s) field. That’s where Dynamic Forms shines. You can customize the section, leaving only relevant fields, right here in the Lightning App Builder—without using the page layout editor at all.

Finally, delete unnecessary fields.

  1. In the Additional Information section, hover over the Main Competitor(s) field and click Delete to delete it.
  2. Click the Details tab.
  3. Expand the Opportunity Information section, then delete the Primary Campaign Source field.
  4. Delete the Next Step field. 
    See how the column automatically adjusts?
  5. Drag the Stage field above the Close Date field.
  6. Save the page.

The changes that you made here are a simple example of what you can do with Dynamic Forms. For pages that have 100 fields or more in the original Record Detail block, this kind of optimization can significantly improve page performance. Pages with fewer fields to display load faster. And your users don’t have to scroll as much to access the fields that they need.

Make Your Dynamic Forms-Enabled Record Page Mobile-Friendly

As part of the page migration process, the Record Detail component is removed from the page. And when you migrate a record page that supports both the desktop and phone form factors to Dynamic Forms, a Record Detail - Mobile component is added to the page for you. 

The Record Detail - Mobile component displays the original Record Detail component in a mobile-only container. So, on pages that support both desktop and phone, your desktop users see the Field Section components, and your mobile users see the Record Detail - Mobile component.

But wait…that’s not really an ideal situation, is it? You want your mobile users to see the same set of curated fields that the desktop users do. Luckily, there’s a solution for that: Dynamic Forms on Mobile. 

Time to mobile-ize Dynamic Forms-enabled record pages in the org.

  1. From Setup, enter Mobile in the Quick Find box, and select Salesforce Mobile App.
  2. Enable Dynamic Forms on Mobile

Dynamic Forms on Mobile enablement toggle in Setup

With that flip of a toggle, record pages that use Dynamic Forms can now display the same customized fields to both your desktop and your mobile users. Any future record pages you create and upgrade to use Dynamic Forms after this point will automatically display the customized fields on mobile and won’t contain the Record Detail - Mobile component.

However, because the New Opportunity Page was created before you flipped the toggle, there’s one more thing to do before it’s mobile-ready. If you enable Dynamic Forms on Mobile and your existing Dynamic Forms-enabled record page includes a Record Detail - Mobile component, your users still see only the Record Detail - Mobile component from their mobile device. You can fix that.

To give your mobile users the same Dynamic Forms experience as the desktop users, you need to remove the Record Detail - Mobile component from existing pages. 

  1. From Setup, enter App Builder in the Quick Find box, then select Lightning App Builder.
  2. Click Edit next to the New Opportunity Page.
  3. Click the Details tab on the canvas.
  4. Hover over the Record Detail - Mobile component and click Delete to delete it.
  5. Save the page.

You take a look at the finished New Opportunity Page on both desktop and mobile in the next unit.

Now that you know something about what Dynamic Forms can do, give it a try in your own org!

Want to keep up with the latest news about Dynamic Forms? Join the Dynamic Forms and Actions Trailblazer Community, where the product teams respond to your questions, concerns, and feedback. You can also view the Dynamic Forms and Actions roadmap there.


Keep learning for
Sign up for an account to continue.
What’s in it for you?
  • Get personalized recommendations for your career goals
  • Practice your skills with hands-on challenges and quizzes
  • Track and share your progress with employers
  • Connect to mentorship and career opportunities