Skip to main content

Repeater

Repeater renders its nested blocks once per row in a list. Use it for a flexible card layout when a regular table doesn’t give you the presentation you want.

Availability

Repeater can be used in all placements. It cannot sit inside another Repeater.

Add and configure

  1. Add Repeater from Structure.
  2. Choose a Data source (list).
  3. Optionally set Rows shown from 1 to 25. An empty field uses the source’s/default count.
  4. Write a Message when empty.
  5. Drag display building blocks into the content area.
The repeater must have at least one and can have up to 10 direct children. A new block starts with a Status tag bound to the first known row field.

Use the row’s fields

Select a nested block. Its dynamic field picker gets the Row group, e.g. “Row · Deal name” or “Row · Amount”. It refers to the current row for each repetition. The list source can be associated records or a list from a connected system. A row field is only valid inside the Repeater that provides the list.

Blocks not allowed inside

The following cannot be used inside a Repeater:
  • Input field;
  • Buttons;
  • CRM action;
  • another Repeater.
The restriction also applies if they sit inside a Row/column or Accordion under the Repeater. The reason is that interactive blocks would otherwise get the same ID across multiple rows.

Data, rules, and steps

The repeater can be assigned to a step and have an overall visibility rule. The nested blocks can have rules that use the row’s own values, for example only showing a critical status tag on overdue invoices.

Limitations and tips

Use Table for many homogeneous columns. Use Repeater when each row needs multiple lines of text, statuses, or a grouped layout. Limit the row count in the sidebar to avoid a very long card.