Specifications Items

Specification items are the selectable values created under a specification. These are required only when the specification type is checkbox.

For example:

  • Specification: Color
    • Specification items: Black, White, Blue
  • Specification: Size
    • Specification items: Small, Medium, Large
  • Specification: RAM
    • Specification items: 4 GB, 8 GB, 16 GB

Specification items let you define what choices customers will see for that spec. They also power product variations and filters on the storefront.

Why Specification Items Matter
  1. Consistent product options
  2. Instead of typing options manually for each product, you define them once and reuse them everywhere.

  3. Cleaner data
  4. A single list of items under each spec prevents spelling mistakes, duplicates and inconsistent formatting.

  5. Filter support
  6. For checkbox-type filters, these items become the options customers can select when browsing.

  7. Variant creation
  8. If the specification is marked as a variant, these items become the variant options on the product page.

Specification Item Fields Explained
  1. Item Name
    The actual value the customer will select.

    Examples:

    • “Black”
    • “XL”
    • “256 GB”
    • “Leather”

    Keep it simple and consistent.

  2. Specification Reference
    This links the item to its parent specification.

    For example:

    • If the specification is Color, all color names belong under that spec_id.
    • If the specification is Size, all size options belong under that spec_id.
  3. Color Code
    Optional. Used when the item represents a color.
    Helpful for showing color swatches on the product page or filters.
    Input should be: Hex code (000000)
    If you leave it empty, the system will display only the text label.
When Specification Items Are Required?
Specification items must be created only when the specification type is checkbox.

This is because checkbox filters need predefined values.

Other filter types work differently:

  • Range: You enter numeric ranges, not items.
  • Slider: You set min and max values.
  • Text: No filtering, so no items needed.
Best Practices for Specification Items
  • Keep item names consistent across similar specs.
  • Avoid duplicates like “Black” and “black.”
  • Add color codes when relevant for a better visual experience.
  • Don’t create unnecessary items. Only add options you actually use for products.
  • Review item lists before making the specification filterable to ensure they make sense to customers.