Product attributes

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

TypeOptions / Description
TextSingle-line text
Long TextMultiline text
ColorColor value
ListPredefined values (Text, Color, or Metric); optional multi-select
DateCalendar date
MetricUnit-based value (Weight, Volume, Length, Area; Metric or Imperial units)
NumberNumeric value
💡

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.

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.