Product Fields: Types, Validation, Scope, And Quality
Define product fields as a strict data contract with clear validation, localization, and channel scope rules.
Common paths
/{workspaceSlug}/settings/product-fields/{workspaceSlug}/products/{productId}/{workspaceSlug}/products/{productId}/variants/{variantId}Field definition checklist
Every new product field should be created with a documented purpose and lifecycle owner.
- Business purpose: why this field exists and who consumes it.
- Data type and format: exact value shape and examples.
- Ownership: who approves value standards and change requests.
- Required/optional state and publish impact when empty.
- Scope rules: global versus market/channel/locale specific.
Choosing the right field type
Use the most constrained field type available so validation can prevent bad data at entry time.
- Identifier fields for SKUs, GTINs, and other controlled IDs.
- Measurement fields for numeric values with unit expectations.
- Select or enum fields for controlled vocabularies.
- Table/structured fields for repeatable spec blocks.
- Media/document fields for slot-based asset attachments.
- Text fields for narrative content with length guidance.
Validation and uniqueness strategy
Validation should reflect business-critical constraints without over-blocking editorial workflows.
- Apply required only where missing values should block completion.
- Use uniqueness for true identifiers, not descriptive text.
- Define min/max length and format expectations for text-like fields.
- Use controlled options for fields that drive filters and exports.
- Plan fallback behavior for empty optional fields in downstream feeds.
Scope, localization, and channel behavior
Field scope decisions determine where values can vary and who can edit them.
- Keep core master data global unless variation is necessary.
- Use localized fields only for translatable customer-facing content.
- Use channel-aware fields for destination-specific requirements.
- Restrict markets/channels/locales when values are not universally valid.
- Test for missing scoped values before enabling publish automation.
Quality controls and rollout
Schema quality is maintained by testing and monitoring, not one-time setup.
- Create test records for each family and variant pattern.
- Run completeness checks in all target market/channel contexts.
- Validate integration/export payloads for new or changed fields.
- Monitor rejection and validation error patterns after launch.
- Audit stale, duplicate, or low-population fields quarterly.