Repeatable settings

Repeatable settings let one module contain a list of items instead of a single fixed set of inputs. They are one of the most useful tools for building flexible modules without duplicating code.

Use repeatable settings for things like:

• product lists
• article cards
• icon rows
• link lists
• FAQs
• testimonials

How they work

When a setting is marked as Repeatable, marketers can add, remove, and reorder instances of that setting in the Email Editor.

Each repeated item shares the same structure, which keeps the module consistent while still allowing flexible content.

Key options

When you create a repeatable setting, pay attention to these fields:

• Item name: the singular label for one item, such as Product, Article, or Link
• Default number of items: how many items should be created when the module is added
• Minimum items: the fewest items marketers can leave in the list
• Maximum items: the most items marketers can add to the list

Leave minimum and maximum blank when the list should be unrestricted.

These choices have a huge effect on usability.

TODO: Add a screenshot of a repeatable setting configuration showing Item name, Default number of items, Minimum items, and Maximum items.

Limiting item counts

Use item limits when the module layout or content model only works within a clear range.

For example:

• Set Minimum items to 1 when a module should never render empty.
• Set Maximum items to 4 for a product grid designed for up to four products.
• Set the same minimum and maximum, such as 3 and 3, when a layout must always have an exact number of items.

When a limit is set, the Email Editor prevents marketers from adding too many items or removing too many items. If both fields are blank, marketers can add or remove items without a count restriction.

Make sure the Default number of items fits inside the range. For example, if the minimum is 2 and the maximum is 4, use a default of 2, 3, or 4.

When repeatable settings are the right choice

Repeatable settings are a good fit when:

• the same content structure can appear several times
• marketers should be able to add or remove entries without switching modules
• you want one module to scale from a small list to a larger list

Repeatable settings are usually a bad fit when each item has meaningfully different layout or behavior. In that case, separate modules are often cleaner.

Design tips

• Use clear singular item names.
• Start with realistic default content so the preview looks intentional.
• Add item limits when the design would break with too few or too many items.
• If the count is flexible, test the module at the minimum, maximum, and an odd number of items.
• Keep each repeated item lightweight. Too many fields per item can become overwhelming fast.
• Use global template settings for shared styling rather than repeating style controls inside every item.

Liquid pattern

Repeatable settings are typically rendered with a loop in Liquid:

{% for item in products %}
  <tr>
    <td>{{ item.title }}</td>
  </tr>
{% endfor %}

The exact variable naming depends on your template structure, but the underlying idea stays the same: one setting group, many instances.

Common mistakes

• Making the item structure too large or too technical
• Using generic item names like Item when the content has a clear purpose
• Starting with zero defaults when the module needs a strong first preview
• Setting a minimum or maximum without checking that the Liquid layout handles every allowed count
• Using repeatable settings for content that should really come from a feed

If the repeated content should sync from external data rather than be entered manually, use Feeds in settings instead.

TODO: Add a short video showing a marketer adding, editing, and removing repeatable items inside one module.