Skip to main content

How to Configure Layouts

Layouts control how a module's fields actually get arranged on screen: which fields are grouped together, in what order, and inside what kind of container. Every module's Layout Builder tab starts empty, and each layout gets built from scratch. This page walks through the specific settings inside all four layout types, using the Products module as the example throughout.

Licenses

The Layout Builder is part of the Custom CRM Modules capability, available from Starter and above.

info

Layouts only control arrangement, not behavior. The Category → Subcategory auto-fill and the Primary Contact relationship used as examples throughout this page come from that module's own Dependencies tab, a separate part of module configuration covered in Configuring CRM Dependencies. A dependency keeps working the same way no matter which layout, or which section within a layout, its fields end up placed in.

Layout Builder tab on the Products module, empty, showing a New Layout button and a No layouts found message

The Four Layout Types​

Clicking New Layout offers a choice of four, each meant for a different screen, and each with its own distinct settings, covered one by one below.

New Layout menu open showing Detail Page Layout, Index Page Layout, Form Layout, and Summary Layout

TypeUsed for
Detail Page LayoutThe full record view: everything visible when a single record is opened.
Index Page LayoutThe list/table view showing many records at once.
Form LayoutThe create/edit form used when adding or updating a record.
Summary LayoutA condensed view, such as a preview card or panel referencing the record from elsewhere.

Detail Page Layout​

Choosing Detail Page Layout opens a blank canvas: a name, a base shape, and a row of block buttons to build the page one piece at a time.

SettingWhat it does
Layout NameLabels the layout in the saved list, e.g. "Product Detail."
Side-by-Side / StackedThe base column arrangement for whatever blocks get added.
View OptionsShow History, Show Conversation, and Hide when no data, each an independent checkbox.

Empty Detail Page Layout builder on Products, showing Layout Name, Side-by-Side/Stacked toggle, View Options, and block type buttons

View Options menu open showing Show History, Show Conversation, and Hide when no data checkboxes

Create Buttons​

Create Buttons add standalone buttons to the top of the detail view, each opening a blank form for a different module.

  1. Click + Create Button. Located above the blocks, next to a "Create Buttons:" label that reads None configured until at least one module is added.
  2. Pick one or more modules. Select Modules opens a list of every other module in the system.
  3. Click OK.

Configure Create Buttons dialog with a Select Modules field and explanatory text

"Each selected module will appear as a standalone Create button in the detail view header. No relationship is created, the form opens without any pre-filled relation."

Each module picked becomes its own removable chip next to the Create Buttons label, with a settings (gear) icon to reopen Select Modules and a × to drop that one module:

Create Buttons label showing a Comments chip with a gear icon and a close icon, plus a plus Create Button control to add more

Comments added as a Create Button; + Create Button stays available to add more.

Blocks​

Every block is a container for content, added from the same row of buttons wherever it appears, including nested inside a Table's row expansion or a Tabs panel.

BlockHolds
SectionA plain group of fields, added directly with + Fields.
TableA tabular list, of either a related module or a non-related one.
ThreadA running feed pulled from a related module, such as comments.
ListA vertical list of related records shown as cards.
TabsMultiple panels switched between by tab, each able to hold its own blocks.
AccordionCollapsible stacked panels.
Grid ViewAn activity feed linked to another CRM module.

Section​

The simplest block: a plain group of fields, and the only block type that renders directly on a Products record right now.

  1. Add the block. Click Section from the block row. An empty Section block appears, blank apart from a red delete (trash can) icon in its top right corner and a + Fields control lower down.
  2. Click + Fields. Opens a field picker scoped to this module.
  3. Pick the fields. Selecting one or more fields, e.g. Category and Subcategory, adds them to the section immediately, previewed with sample values.
  4. Click Save Layout.

A new empty Section block added to the Detail Page Layout, with a delete icon and a plus Fields link

Section block showing Category and Subcategory fields added, with the layout renamed to Product Detail

note

That red delete icon isn't unique to Section: every block type carries one in its top right corner. Clicking it asks "Delete this section?" (or the matching name for that block type) with Cancel and OK, so nothing is removed until OK is confirmed.

On the record page itself, a Show empty fields switch is located below the section's own fields, off by default. With it off, any field carrying no value is left out entirely rather than shown blank.

Record page with Show empty fields switched off, hiding Created By, Modified By, and Primary Contact since none are set on this record

Off: Created By, Modified By, and Primary Contact are left out since this record has no value for them.

Record page with Show empty fields switched on, revealing Created By, Modified By, and Primary Contact as a dash

On: the same fields reappear, each showing a dash where no value is set.

warning

This switch is a per-viewer preference on the record page, not a Layout Builder setting. It cannot be turned on by default for everyone from the builder; each person toggles it for themselves.

Table​

Shows a tabular list inside the detail view, either of records related to the one being viewed, or of any other module entirely.

  1. Add the block. Click Table from the block row. A New Table block appears with a Select Table control.
  2. Open Configure Table. Click Select Table (or Configure, once already set) to open the dialog.
  3. Pick a Module Type. Related Module lists records from a module that already has a relationship pointing at this one. Non-Related Module lists any module's records instead, matched manually against a field on this record.
  4. Fill in the fields that appear. Related Module asks for a Related Module List. Non-Related Module asks for a Module and a Search Based On (Main Module Field), the field on this record used to filter that other module's list.
  5. Set the rest, optionally. Table Columns picks exact columns (blank keeps the default visible list); Show Summary View adds a condensed summary; Add Custom Action Buttons and Categorize Data into Tabs unlock once a related module is set; Default Filter auto-applies a filter whenever the table loads.
  6. Click OK, then Save Layout. The block keeps whatever was configured; Save Layout commits it to the record page.

On Products, no other module has a relationship pointing back at it yet, so Related Module List has nothing to offer. Non-Related Module works around that: picking Contacts as the Module and Primary Contact as Search Based On shows the Contact this Product actually points to, filtered by that field instead of a two-way relationship:

Configure Table dialog set to Non-Related Module, with Module set to Contacts and Search Based On set to Primary Contact, plus Table Columns, Show Summary View, and Default Filter controls

Thread​

Shows a running feed of records from a related module, styled like a comment thread.

  1. Add the block. Click Thread from the block row. A New Thread View block appears.
  2. Click Configure. Opens Configure Thread View.
  3. Pick the Related Module. Only modules with an existing relationship pointing at this one are offered here; unlike Table, Thread has no non-related fallback.
  4. Map Avatar, Title, and Content. Avatar sets the field used as each entry's avatar/initials, Title the author or heading field, Content the message body field.
  5. Click OK, then Save Layout.

New Thread View block added, prompting to click Configure to select a related module

Configure Thread View dialog with Related Module, Avatar, Title, and Content fields

warning

On Products, Related Module comes back empty: no other module has a relationship field pointing at Products yet, and Thread, unlike Table, has no way to work around that. A Thread only becomes usable here once such a relationship exists, e.g. a Comments-style module built to reference Products directly.

List​

Shows related records as a vertical list of cards rather than a table.

  1. Add the block. Click List from the block row. A New List View block appears.
  2. Click Configure. Opens Configure List View.
  3. Pick the Related Module. Same restriction as Thread: only modules already related to this one are offered, with no non-related option.
  4. Map Title, Description, Avatar, and Status. Title is the card's primary display field, Description a secondary/subtitle field, Avatar the card's avatar field, Status the field shown as a status badge.
  5. Click OK, then Save Layout.

New List View block added, prompting to click Configure to select a related module

Configure List View dialog with Related Module, Title, Description, Avatar, and Status fields

warning

Same story as Thread: Related Module comes back empty on Products until another module has a relationship pointing at it.

Tabs​

Splits content into switchable panels. Each tab gets its own independent row of block buttons, so a single Tabs block can hold a Section in one tab and a Table in another.

  1. Add the block. Click Tabs from the block row. A New Tabs block appears with one tab already in it, Tab 1.
  2. Add more tabs, as needed. Add Tab, next to the block's own title, appends another one.
  3. Rename each tab. The pencil icon next to a tab's label opens an Edit Name dialog with a single Label field.
  4. Add content inside each tab. Selecting a tab reveals its own + Fields / Section / Table / Thread / List / Tabs / Accordion / Grid View row, completely independent of every other tab's content.
  5. Click Save Layout.

On Products, renaming Tab 1 to Contact and the second tab to Category, then adding the Primary Contact field to the first and Category/Subcategory to the second, gives two purpose-named tabs on the one block:

New Tabs block with Tab 1 selected, showing its own row of block type buttons for adding content inside that tab

Tabs block renamed with two tabs, Contact and Category, Category selected and showing its own block row

Accordion​

Stacks content into collapsible panels instead of side-by-side tabs. Each panel expands or collapses independently and can hold its own blocks, the same as a Tabs panel.

  1. Add the block. Click Accordion from the block row. A New Accordion block appears with one collapsed panel, Panel 1.
  2. Add more panels, as needed. Add Panel, next to the block's own title, appends another one.
  3. Expand a panel to work on it. Clicking the panel header toggles it open; it stays open while blocks get added inside.
  4. Rename the panel. The pencil icon next to its label opens the same Edit Name dialog Tabs uses.
  5. Add content inside. An expanded panel gets its own + Fields / Section / Table / Thread / List / Tabs / Accordion / Grid View row.
  6. Click Save Layout.

On Products, Panel 1 renamed to Record Info and filled with the Id and Created At fields:

New Accordion block with a single collapsed Panel 1 and an Add Panel control

Full layout builder showing the Section, Tabs with Contact and Category tabs, and Accordion with a renamed Record Info panel

Grid View​

Despite the name on the block button, this configures as an activity feed: it links the record to another CRM module and shows that module's related activity as a grid of cards.

  1. Add the block. Click Grid View from the block row. It opens straight into Configure Activity Feed.
  2. Pick Link to CRM Module. Only modules already related to this one are offered, the same as Table's Related Module option.
  3. Map Title Field, and optionally Description and Avatar. Title Field is required; Description Field and Avatar Field are optional extras shown on each card.
  4. Click OK, then Save Layout.

On Products, Link to CRM Module offers Contacts, since Primary Contact already relates the two. Setting Title Field to First Name completes it:

Grid View block with a Configure Activity Feed dialog open, showing a Link to CRM Module field set to Contacts

Configure Activity Feed dialog with Link to CRM Module set to Contacts and Title Field, Description Field, and Avatar Field dropdowns

Once configured, the block previews a 3×3 grid of placeholder cards right in the builder, before any layout gets saved:

Grid View block showing a Grid Preview 3x3 layout with six placeholder cards labeled First Name and status tags Active, Pending, Closed

Index Page Layout​

Controls the list screen that shows many Products records at once. Unlike the Detail layout, this one has a single fixed shape with its own settings rather than a block picker.

SettingWhat it does
Layout NameLabels the layout in the saved list.
View typeTable, List, Grid, or Kanban: the base shape the list renders in.
Table ColumnsWhich fields appear as columns, added one at a time.
Default FilterA filter auto-applied every time the list loads, configured per field.
  1. Open the builder. New Layout → Index Page Layout opens directly into an empty builder, no intermediate dialog.
  2. Name it and pick a view type. Layout Name labels it in the saved list; Table, List, Grid, or Kanban sets the base shape.
  3. Add columns, one at a time. Table Columns opens a picker; each field added appears immediately in the live preview on the right, against real records.
  4. Set a Default Filter, optionally. Set Default Filter opens a panel covering every field on the module, each with its own operator and value, auto-applied whenever the list loads.
  5. Click Save Layout.

Empty Index Page Layout builder showing Layout Name, Table/List/Grid/Kanban toggle, Table Columns, Default Filter, and a live search and pagination preview

Adding a column, e.g. Category, immediately previews it against real records on the right:

Category column added to the Index Page Layout, with a live preview table showing Category values, search box, and pagination

Table Columns builds the list one field at a time; the preview on the right updates immediately.

Set Default Filter opens a full filter panel covering every field on the module, including the system fields and any relationship fields like Primary Contact:

Configure Default Filter panel listing every field on Products with its own operator and value input, marked auto-applied when list loads

Form Layout​

Controls the create/edit form: which fields appear, in what order, and grouped into which sections.

SettingWhat it does
Layout NameLabels the layout in the saved list.
Applies ToCreate and/or Edit, independent checkboxes for whether this form shows up on new records, existing ones, or both.
Expanded / CollapsedWhether the form's sections start open or closed.
Available FieldsEvery field not yet placed on the form, each with a drag handle.
Add SectionCreates another named group to drag fields into, alongside the default one.
  1. Open the builder. New Layout → Form Layout opens directly into an empty builder, with Applies To set to both Create and Edit, and Expanded selected, by default.
  2. Name it. Layout Name labels it in the saved list, e.g. "Product Form."
  3. Set Applies To. Untick Create or Edit to limit the form to just one of the two; leaving both ticked uses this layout for new records and existing ones alike.
  4. Set Expanded or Collapsed. Controls whether the form's sections start open or closed when someone lands on the form.

New Form Layout builder showing Applies To Create/Edit checkboxes, Expanded/Collapsed toggle, an Available Fields list with drag handles, and a Default section with a Drag fields here area

The builder starts with every field, Category, Subcategory, and Primary Contact, remaining unplaced in Available Fields, and one empty section named Default.

  1. Drag a field from Available Fields into the Default section. Dropping it removes it from Available Fields and places it in the section, previewed immediately with its real control, a dropdown for Category, in this case.
  2. Repeat for every field that belongs in that section. Each one lands in the order dropped, and can be reordered afterward by dragging within the section.

Form Layout builder showing Category and Subcategory fields placed inside the Default section, each rendered as a real dropdown control, with one field, Primary Contact, still left in Available Fields

Category and Subcategory placed in Default; Primary Contact still waiting in Available Fields.

  1. Add another section, if the remaining fields belong elsewhere. Add Section opens an Add New Section dialog asking for a Section Name.
  2. Drag the remaining fields into it. Same drag motion as before, just into the new section's own drop zone.
  3. Click Save Layout.

On Products, a second section named Contact holds Primary Contact, separate from Category and Subcategory in Default:

Completed Form Layout with two sections: Default holding Category and Subcategory, and Contact holding Primary Contact, with Available Fields showing All fields placed

Two sections, three fields, nothing left unplaced.

warning

Saving this Form Layout did not change the actual New Products form on Products: it still shows Category, Subcategory, and Primary Contact as one flat list, with no Default/Contact section split. The live form appears to run on its own built in field order rather than picking up a saved Form Layout automatically here.

New Products form showing Category, Subcategory, and Primary Contact fields as one flat list

The real New Products form: same three fields, but without the section split defined in Product Form.

Summary Layout​

Builds a condensed view of the record, e.g. for a preview card referencing it from somewhere else. It shares the same drag-from-a-list pattern as Form Layout, but with a single flat list instead of sections.

SettingWhat it does
Layout NameLabels the layout in the saved list.
Available FieldsEvery field not yet placed in the summary, each with a drag handle.
Summary FieldsThe fields shown in the summary view, in the order they're dragged in.
  1. Open the builder. New Layout → Summary Layout opens directly into an empty builder: Available Fields on the left, an empty Summary Fields drop zone on the right.
  2. Name it. Layout Name labels it in the saved list, e.g. "Product Summary."

New Summary Layout builder with an Available Fields list on the left and an empty Summary Fields drop zone on the right

  1. Drag a field from Available Fields into Summary Fields. Unlike Form Layout, there are no separate sections here, just a single flat drop zone.
  2. Repeat for every field the summary should show. Each one gets a running number, 1, 2, 3, and so on, plus its own type badge and a remove (×) icon.
  3. Reorder by dragging within Summary Fields, if needed. The numbering updates immediately; this order is exactly what the summary view displays in.
  4. Click Save Layout.

On Products, Category, Subcategory, and Primary Contact dragged in, in that order:

Summary Layout builder showing Category, Subcategory, and Primary Contact placed in Summary Fields, numbered 1 to 3, each with a type badge and remove icon, with a Clear link above the list

Three fields, numbered in the order they were dragged in; Clear empties the list in one click.

Managing Saved Layouts​

Once saved, a layout shows up as a card on the Layout Builder tab, tagged with its type and whether it's the default for that type.

Layout Builder tab showing the saved Product Detail layout card, tagged Detail and Default, with favorite, duplicate, share, edit, and delete icons

Each saved layout card carries five actions: mark as favorite, duplicate, share, edit, and delete.

ActionWhat it does
Favorite (star)Flags a preferred layout among several of the same type.
DuplicateCreates a copy to modify without touching the original.
ShareShares the layout, e.g. with another module or user group.
Edit (pencil)Reopens the builder to change the layout.
DeleteRemoves the layout permanently.

Sharing a Layout​

Every saved layout carries its own Share Layout dialog, separate from whatever permissions apply to the module or its records. This controls who else can even see and use that particular layout.

  1. Click the Share icon. The share icon is located on the layout's card, alongside favorite, duplicate, edit, and delete.
  2. Review People with access. The owner is listed here by default, e.g. the person who created the layout, tagged Owner.
  3. Add specific people, groups, or roles, optionally. The type dropdown switches between User, Group, and Role; the search box next to it finds and adds a specific one to the People with access list.
  4. Set General access. Restricted or Users with module access, covered in detail below.
  5. Click Done.

Share Layout dialog with a User type dropdown, a search box, People with access showing the owner, and General access set to Restricted

By default, General access is Restricted: "Only people explicitly shared can open this layout."

Switching General access to Users with module access opens up a second dropdown for the permission level itself:

Share Layout dialog with General access set to Users with module access and a Can view permission dropdown, noting Users with access to this Products can open this layout

"Users with access to this Products can open this layout," once General access moves off Restricted.

General accessMeaning
RestrictedOnly people explicitly added to People with access can open this layout.
Users with module accessAnyone who already has access to the Products module can open this layout, without being added individually.
Permission levelMeaning
Can viewCan open and use the layout; can't make changes to it.
Can editCan make any changes to the layout itself.