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:


Enabling repeatable fields

To enable repeatable fields 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.

When finished, save your structure and return to your item.

Note: If the repeatable setting is later disabled, any repeated fields will become disconnected from the structure. These fields will show a warning icon in the item editor. Click on this to delete the field, making sure any content you wish to keep is moved into another field.

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.

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, repeated fields are represented differently depending on actions undertaken.

Repeatable fields that have been added are highlighted in green:

Repeatable fields that have been deleted are highlighted in red:

Repeatable fields that have been reordered are highlighted in purple:

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?