Template Docs Commerce APIs Webhooks Custom Code Upcoming Changes
Get Started
Get Started

About product attributes

What is an attribute?

Attributes are characteristics of physical and service products that allow different variants of the same product. For example, a merchant may sell Pies as a product with "Flavor" as an attribute, where "Key Lime" and "Pecan" may be different variants of Pies.

Note that gift card products have variants, but they do not have attributes.

When can I create attributes for a product?

When creating a physical or service product in the Squarespace UI, a variant without attributes is created by default. In order to distinguish any new variants from each other, attributes (known as "Options" in the UI) must be added to the product first.

A physical or service Product must have at least one variant and attributes adhering to the following conditions.

# of Product.variants Product.variantAttributes # of attributes; min # of attributes; max
1 Not required 0 6
2 or more Required 1 6

Further reading