Repeatable Fields

Create duplicate fields, repeatable fields in an item without changing the items structure or template.

Bruno Wilson avatar
Written by Bruno Wilson
Updated over a week ago

This guide includes the following;

Configuring a text field to be repeatable

To add a repeatable field open the structure and template editor.

Either create a new text field or update an existing field by clicking the ‘repeatable’ button in the top right of the field. Then, to make a text field repeatable, switch the “enable” toggle on.

Leaving the “Limit to” toggle switched off will mean you can repeat this text field as many times as you like. Setting a limit, restricts the number of times the given text field can be repeated.

'Save & close' to return to your item or 'Save as template'.


Creating a repeated text field

Open an item containing a repeatable text field as defined in the previous section. In the example above we created a structure containing one repeatable and one non-repeatable text field.

The repeatable text field will now have a button below to add another text field:

Click this button to repeat the text field.

If you set a limit on the number of repeats allowed on the text field, then you will be notified of that limit being reached as per the below screenshot:

Re-ordering repeated text fields

You can quickly reorder repeated fields by clicking the field header and dragging it to its required location.

Alternatively, you click on the options menu and move the field up and down. Moving fields up and down this way will move the field one position at a time.

Deleting repeated text fields

To delete one of the repeated fields, simply choose 'Delete' from the options menu. Deleting a repeated text field containing content will ask you for confirmation.

Repeatable field revision history

When reviewing revision history there are new events to note around repeatable field changes.

Firstly, a repeatable field being added is highlighted in green in the revision it was added:

A deleted repeatable field is highlighted in red in the revision it was deleted:

Repeatable fields that have been re-ordered are highlighted in purple in the revision the were re-ordered in:

FAQ's

API V2 Breaking changes

In order to support repeatable fields when fetching, updating and creating items via the API we had to slightly alter the request (create/update) and response structures (fetch) when dealing with items on the new API version. This will only affect users directly using our v2 API, and the updated documentation can be found at https://docs.gathercontent.com


Did this answer your question?