Organize Collection fields into groups

Group related Collection fields into labeled sections so large Collections stay organized.

As a Collection grows, a long, flat list of fields gets harder to scan and hand off. Field groups let you organize related fields into named sections, so you and your collaborators can find what you need faster.

How field groups work

Field groups are a visual aid to help how fields are organized and displayed, they don’t change how your content behaves. Grouping doesn't affect field behavior, item data, filtering, sorting, API queries, or your published site.

Site managers and designers can create, edit, reorder, and delete field groups in CMS tab > a Collection > Collection Settings. Groups can’t be nested inside another group.

When team members edit a Collection item, they can expand or collapse field groups to focus on the fields they want to work with. Each group’s collapsed state is remembered for each team member (i.e., if you collapse a group, it will remain collapsed until you expand it).

Create a field group

To create a field group:

1. Open Collection Settings
2. Click Add group
3. Type in a group name and a group description
4. Click Create

You can now drag existing fields into the group, or click Add field within the group to add a new one.

Edit a field group’s name or description

To rename a field group:

1. Open Collection Settings
2. Click the Options icon to the right of the group name
3. Click Edit
4. Edit the group name and/or group description
5. Click Save

Reorder field groups

To reorder field groups:

1. Open Collection Settings
2. Drag a group to a new position

Fields inside a group move with the group when you reorder it.

Delete a field group

Deleting a field group doesn't delete any fields. The fields inside the group are moved to the default Custom fields group and keep working normally.

To delete a field group:

1. Open Collection Settings
2. Click the Options icon to the right of the group name
3. Click Delete

Field groups and the CMS API

Field groups are available through the CMS Data API. Get Collection returns a fieldGroups array, where each group includes its name and the IDs of the fields assigned to it. Fields that aren't assigned to a group are treated as ungrouped. You can also set groups when you create or update a Collection, and assign a field to a group using groupId when you create or update a field.

The collection_schema_updated webhook isn't available yet. To detect schema changes in the meantime, periodically query the Get Collection endpoint.