Live now/Structured product content, partner portal delivery, and pricing that scales by volume.
Stackcess
Back to Help Center
Settings And Admin12 minUpdated March 14, 2026

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.

  1. Create test records for each family and variant pattern.
  2. Run completeness checks in all target market/channel contexts.
  3. Validate integration/export payloads for new or changed fields.
  4. Monitor rejection and validation error patterns after launch.
  5. Audit stale, duplicate, or low-population fields quarterly.
Have Your Say