Product Attributes

Product attributes describe the characteristics of a product and define the structure of the product page. They are essential for categorizing products and enabling efficient navigation, filtering, and display in Djust.

🔄

Product attributes are not the same as product variants.

Attributes vs. Variants

• Attributes describe what a product is (e.g., its material, color, or dimensions).
• Variants are different versions of a base product that share most of its attributes but vary in specific ways (e.g., color).

For example:

• Main product: Set of Tiles (described using attributes such as size, composition)
• Variants: Red Set of Tiles, Blue Set of Tiles, Black Set of Tiles

Attribute structure

Each product attribute includes:

• Name: The label used in the back-office and optionally in the storefront
• Type: Defines the data format of the attribute
• External ID: Unique identifier, used especially for imports and integrations

Available attribute types

💡

If the unit you're looking for does not exist (for metric attributes), go to Settings → General Settings → Product Units to add a custom unit.

Validation rules

Number and Metric attributes

Attributes of type Number and Metric (including List Number and List Metric) enforce strict value validation:

• Empty string values ("") are not accepted and will return a 422 error when submitted via the API (e.g., PATCH /v1/products, POST /v1/assortments/{id}/products).
• null values and empty strings are silently ignored during updates — the attribute value is simply not stored.
• During CSV import, if the column for a Number or Metric attribute is empty, the value is ignored without causing an import error.

Best practices

• We recommend importing product attributes via .csv to benefit from a history of imports and a more efficient process than manual entry.
• If your existing systems already define attributes and external IDs, consider reusing them to maintain consistency.
• Use the same external IDs across systems whenever possible to streamline data synchronization.

How to create product attributes

1. Navigate to: Settings → Catalog and Offer Management → Product Attributes
2. Click + Add attribute
3. Fill in the following:
   • Name
   • Attribute type (see table above)
   • External ID (no spaces or accents)
   • (Optional) Translations for the attribute name
4. Click Create to save the new attribute

Data import

You can import product attributes from existing systems. For more information, see the data import guide.