Custom List Row Templates

Standard list tables are efficient for dense data. But they're not always the right tool. Sometimes a row needs to show a thumbnail alongside a name and description. Sometimes priority, assignee, and due date need to be arranged spatially rather than stacked in columns. Sometimes the default row is just too plain for what the data deserves.

Custom list row templates give you control over the visual structure of every row in a list.

Beyond Column Definitions

Until now, configuring a list meant defining columns: which fields to show, in what order, with what labels. That model works well for tabular data — financial records, inventory items, logs.

But many objects benefit from a richer layout. A task list is more useful when priority is shown as a color band on the left edge, the title is large and prominent, and metadata like due date and assignee is arranged below in smaller type. A product catalog reads better when item images appear inline. A contact list is easier to scan when company and role appear beneath the name.

Row templates make these layouts possible without requiring any code.

Design the Row in the Builder

Open the list component in the builder and switch to row template mode. The row becomes a canvas where you can place fields, labels, images, badges, and layout containers. Arrange them in columns or stacks. Set sizes, weights, and spacing. Use conditional visibility to show certain elements only when values are present.

The template applies to every row in the list. Data flows into the layout automatically — each row renders the same structure with its own values.

Responsive by Default

Row templates adapt to screen size just like any other component. Columns that make sense on a wide desktop screen collapse gracefully on mobile. The builder lets you preview the row at different widths so you can see exactly how the layout behaves before publishing.

Consistent with Field Types

The same universal field rendering applies inside row templates. Dates format according to workspace settings. Statuses appear as badges. Relations show linked record labels. File fields render as attachment indicators. You get consistency without configuring each field individually.

When to Use It

Custom row templates are most valuable when:

• Your object has a mix of primary and secondary information that benefits from visual hierarchy
• Rows contain images or thumbnails that should display inline
• Users need to scan multiple attributes at once without reading across columns
• The default table layout doesn't match how people actually use the data

Standard column-based lists remain the default — they're fast to configure and work well for most data. Row templates are available whenever you need more.