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

These two choices have a huge effect on usability.

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

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.
• 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
• 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.