Repeatable fields are text fields that can be expanded and used in templates and items. They help create flexible structures without the need to edit entire templates when extra text fields are needed.
Enable Repeatable Fields
- Navigate to Content Workflow.
- Select the Template Editor.
- Select the field you want to make repeatable, select
located in the top right, and enable the toggle.
- When the Limit to toggle is disabled that means you can repeat this text field as many times as you want.
- When the Limit to toggle is enabled You can set a limit that restricts the number of times the given text field can be repeated.
- Select Save.
Create a Repeated Text Field
- Navigate to Content Workflow.
- Open an item containing a repeatable text field.
- The repeatable text field will have a button below to add another text field.
- Select
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.
- 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-Order Repeated Text Fields
- You can quickly reorder repeated fields by clicking the field header and Dragging it to its required location.
- Alternatively, you can select
and move the field up and down. This will move the field one position at a time.
Delete Repeated Text Fields
- Open an item containing a repeatable text field
- Select Delete from the options menu.
- Deleting a repeated text field containing content will ask you for confirmation.
Disable Repeated Text Field
If the repeatable setting is disabled, any repeated fields will become disconnected from the structure. These fields will show a warning icon in the item editor.
- Open an item containing a repeatable text field
- Select
to delete the field
- Make sure any content you wish to keep is moved into another field.
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
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