Display groups
Display groups organize attributes into named sections on the product editor. Instead of showing a flat list of all attributes, display groups let you create logical groupings like "Specifications", "Marketing", or "Dimensions" — making it faster and easier to find and edit product data.
How display groups work
A display group is a named container with an ordered list of attributes. When a product's attributes are rendered in the editor, they are grouped by their display group. Attributes not assigned to any display group appear in a default ungrouped section.
Display groups control presentation only — they don't affect which attributes are available (that's determined by the attribute template) or how data is stored.
The display groups list
Navigate to Products → Attributes and click the ⋯ menu → Display Groups.
The list shows:
| Column | Description |
|---|---|
| Name | The group name. |
| Attributes | Count of attributes in the group (e.g., "8 attributes"). |
Use the search bar to filter groups by name. Click any row to open the editor.
Creating a display group
- On the display groups list, click Create Group.
- A slideover opens with one field:
| Field | Required | Description |
|---|---|---|
| Name | Yes | The display group name (e.g., "Specifications", "Marketing Copy", "Dimensions"). |
- Click Create. You'll be redirected to the editor to add attributes.
Editing a display group
The editor slideover shows:
Information card
| Field | Description |
|---|---|
| Name | The group name. Editable. |
Attributes card
The attributes card shows a count badge (e.g., "5 Selected") and has two parts:
Search to add
A searchable select menu at the top lets you find and add attributes:
- Type to search by attribute name or code.
- Each option shows the attribute name with code below.
- Selecting an attribute adds it immediately to the group.
Assigned attributes
A drag-to-reorder list of attributes currently in the group:
- Drag handle — Reorder by dragging.
- Attribute name (bold) with a code badge in a gray pill.
- Trash button — Remove the attribute from the group (appears on hover).
The order in this list determines the display order within the group on the product editor.
Empty state: "No attributes selected — Use the search above to add attributes."
Deleting a display group
Click Delete at the bottom of the editor. A confirmation dialog asks you to verify.
Deleting a display group does not delete the attributes — they simply become ungrouped in the product editor.
Saving changes
Click Save Changes after modifying the name or attribute list. The changes take effect the next time a product is loaded in the editor.
How display groups appear on the product editor
On the product overview page, the Attributes section uses display groups to organize the attribute list. Users can filter by:
- All attributes — Shows everything.
- Attributes with data — Only filled attributes.
- Attributes without data — Only empty attributes.
- Completeness groups — Attributes grouped by completeness criteria.
- Named groups — Your display groups appear as named filter options.
Selecting a display group from the filter shows only the attributes in that group, making it easy to focus on a specific set of product data.
Best practices
- Group by editing workflow — Create groups that match how your team works. For example: "Basic Info", "Technical Specs", "Marketing", "SEO".
- Keep groups focused — A group with 5–10 attributes is easier to work with than one with 50.
- Order attributes by importance — Put the most frequently edited attributes at the top of each group.
- Use clear names — Group names should immediately tell the editor what kind of data they'll find inside.
- Assign all content attributes — Attributes left ungrouped appear in a default section, which can become cluttered. Aim to assign every attribute to a group.