Repeat

Modified on Thu, 20 Aug at 10:59 AM

Repeat

TABLE OF CONTENTS

Repeat content in your documents

Introduction

Use a Repeat building block to collect a list of repeating entries.

A Repeat building block allows the user to add the same set of fields multiple times. This is useful when you need to collect several items of the same type, such as multiple people, products, or addresses.

Each entry inside the repeat follows the same structure, defined by the building blocks placed inside the Repeat building block.

Add a Repeat building block

To add a Repeat building block, click the plus (+) icon in your section and select Repeat.

Insertion of a repeat building block

Insertion of a repeat building block

After adding the Repeat building block, you can insert other building blocks inside it. These building blocks define the fields that will repeat for each entry.

For example, a Repeat building block could contain fields such as:

  • Name
  • Email
  • Phone number

When filling out the form, the user can then add multiple entries using this structure.

General settings

Name
Enter a clear name. This label appears in the Information Tree and helps you identify the repeat section.

Description
Add a short description explaining what type of entries should be added.

Edit content
Add the content that should be repeated in the document.\ The content you add here will be inserted once for each item the user adds to the repeat in the form.

General settings

General settings

Advanced settings

Key
The key automatically inherits the Name you enter in the General settings. If needed, you can change it and define a unique key for the building block.

The system uses the key to reference the repeating data structure in templates and transformations.

Use a clear and consistent naming pattern. For example: participants, items, or addresses.

Advanced settings

Advanced settings

Using Repeat building blocks in templates

When a Repeat building block is inserted into a template, it allows the document to render multiple entries dynamically.

Each entry in the repeat is processed individually, allowing the template to generate repeating sections such as:

  • Lists of attendees
  • Tables of items
  • Multiple addresses

The template will iterate through each item and render the corresponding content.

This allows templates to adapt automatically based on the number of entries provided by the user.

Use separators between items

It is possible to add a separator to the repeat building block after inserting it into the document.

The separator will be added between every iteration of the items added to it.

By default, the separator will be set to "None", which will add a line break between each iteration.

The available options for Separator are:

  • None
  • Newline
  • Custom separator

Common uses for custom separators:

Use caseSeparator settingOutput example
Comma-separated values,Alice, Bob, Charlie
Semicolon-separated lists;Paris, France; Berlin, Germany; Copenhagen, Denmark
Bullet-like inline lists\|Option A \| Option B \| Option C
Slash-separated values/Admin / Editor / Viewer

Repeat building block inside template

Repeat building block inside template


Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article