Attribute Groups: Editor Structure And Governance
Design attribute groups that mirror real workflows so product detail editing is fast, complete, and consistent across teams.
Common paths
/{workspaceSlug}/settings/field-groups/{workspaceSlug}/products/{productId}Why groups matter
Attribute groups are not just visual sections. They define how editors navigate the product page, which affects completion rates and error frequency.
- Strong grouping reduces search time and duplicate edits.
- Weak grouping causes hidden required fields and inconsistent values.
- Group design should align to job roles and review workflows.
Recommended group taxonomy
Use a stable group pattern that teams can recognize across families.
- Core Identity: product name, identifiers, brand-level basics.
- Merchandising: customer-facing copy and discovery fields.
- Technical/Specifications: measurable and factual product data.
- Compliance/Regulatory: required legal and safety content.
- Media/Documentation: imagery and supporting files.
- Channel Overrides: destination-specific values.
Group ordering and section design
Order groups by frequency and criticality. Editors should encounter high-value required fields early.
- Put high-frequency, high-risk fields near the top.
- Keep low-frequency specialist fields in later groups.
- Avoid deeply fragmented groups with only one or two unrelated fields.
- Use clear, operational names instead of internal project language.
Shared vs family-specific groups
Reuse groups where families share workflow shape, but allow family-specific groups when structural needs differ.
- Shared groups reduce training overhead and improve consistency.
- Family-specific groups are justified for unique technical or compliance requirements.
- Document ownership for each group so schema decisions have accountable approvers.
Governance and maintenance
Group structures should be reviewed on a cadence, especially after large imports or channel expansions.
- Audit fields per group for usage and quality issues.
- Merge duplicate or low-value groups where possible.
- Check required-field completion rates by section.
- Re-sequence groups when workflow bottlenecks are identified.
- Communicate changes with release notes for editors and reviewers.