Repeatable Fields in Content Workflow

Bruno Wilson
Bruno Wilson
  • Updated

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

  1. Navigate to Content Workflow. 
  2. Select the Template Editor.[CW] Edit Template.png
  3. Select the field you want to make repeatable, selectScreenshot 2024-05-28 at 2.32.58 PM.pnglocated in the top right, and enable the toggle.[CW] Repeatable button.png
  4. When the Limit to toggle is disabled that means you can repeat this text field as many times as you want.
  5. 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. 
  6. Select Save.

Create a Repeated Text Field

  1. Navigate to Content Workflow.
  2. Open an item containing a repeatable text field.
  3. The repeatable text field will have a button below to add another text field.[CW] Repeat Field Button.png
  4. Select Screenshot 2024-05-30 at 12.01.24 PM.pngto 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.[CW] Limit Reached.png

Re-Order Repeated Text Fields

  1. You can quickly reorder repeated fields by clicking the field header and Dragging it to its required location.[CW[ Drag Repeated.png
  2. Alternatively, you can selectScreenshot 2024-05-28 at 2.38.49 PM.png and move the field up and down. This will move the field one position at a time.[CW] Reorder menu.png

Delete Repeated Text Fields

  1. Open an item containing a repeatable text field
  2. Select Delete from the options menu.
  3. Deleting a repeated text field containing content will ask you for confirmation.[CW] Delete field.png

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.

  1. Open an item containing a repeatable text field
  2. Select  Screenshot 2024-05-28 at 2.37.05 PM.pngto  delete the field
  3. Make sure any content you wish to keep is moved into another field.

[CW] Warning Repeat.png

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:[CW] Green field.png
  • Repeatable fields that have been Deleted are highlighted in red:[CW] Red field.png
  • Repeatable fields that have been Reordered are highlighted in purple:[CW] Purple field.png

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

Share