Product Attributes

Product Attributes are brand-level, reusable field definitions that you can apply across all products. Unlike Custom Attributes (legacy unstructured key/value pairs), Product Attributes support rich field types, filtering, storefront visibility, and variant-level scoping.

Managing Attribute Definitions

Go to Settings → Products → Product Attributes to create, edit, and reorder attribute definitions. Each attribute definition has:

Field	Description
Name	Display label (e.g. “Material”, “Scent”)
Slug	Auto-generated URL-safe key used in templates (e.g. `material`)
Field Type	See full type list below
Applies To	Where values are stored: Product, Variant, or Both
Options	For `select` and `multiselect` types: the allowed values
Required	Whether a value must be set before saving
Filterable	Available as a storefront/catalog filter
Visible on Product Page	Shown in the product page details section

Field Types

Product Attributes support the full set of CRM-style field types:

Type	Input	Use Case
`text`	Single-line text	Short values (colour name, size label)
`textarea`	Multi-line text	Longer descriptions without formatting
`rich_text`	Rich text	Formatted content
`wysiwyg`	WYSIWYG editor	Full rich text editing
`email`	Email input	Contact or support email
`phone`	Phone input	Contact number
`url`	URL input	Product page, demo link
`number`	Number input	Weight, volume, count
`date`	Date picker	Release date, expiry date
`datetime`	Date & time picker	Event datetime
`boolean`	Checkbox (Yes/No)	Organic, Vegan, In stock
`select`	Dropdown	Single value from predefined options
`multiselect`	Checkboxes	Multiple values from predefined options
`color`	Color picker + text	Hex colour value
`image`	URL text input	Image URL
`file`	URL text input	File URL
`json`	Monospace textarea	Structured JSON data

Applies To Scoping

The applies_to field controls where attribute values are stored and edited:

Value	Behaviour
`product`	Value is stored at the product level. Edited in the Attributes tab of the Product Detail Page.
`variant`	Value is stored per variant. Edited in the Variants tab per variant row (coming soon).
`both`	Product-level default, but can be overridden per variant.

Assigning Values to Products

Open any product and go to the Attributes tab. You will see all brand-level attribute definitions that apply to the product level. Fill in values and save. Attributes with applies_to = variant are managed in the Variants tab, not the Attributes tab.

Template Access

List Definitions

{% set attrs = GetProductAttributes() %}
{% for attr in attrs %}
  {{ attr.slug }}: {{ attr.name }} ({{ attr.type }})
{% endfor %}

Filter by scope or visibility:

{% set visibleAttrs = GetProductAttributes({ visible: true, applies_to: 'product' }) %}

Get Product Values

{% set vals = GetProductAttributeValues(product) %}
{{ vals.material }}
{{ vals.scent }}

Shorthand Filters

When a product is loaded via GetProduct(), attribute values and definitions are pre-loaded:

{{ product | attr:'material' }}        — value by slug
{{ product | attrLabel:'material' }}   — display label by slug

Full Display Example

{% set attrDefs = GetProductAttributes({ visible: true }) %}
{% set attrVals = GetProductAttributeValues(product) %}
<dl>
{% for def in attrDefs %}
  {% set val = attrVals[def.slug] %}
  {% if val %}
    <dt>{{ def.name }}</dt>
    <dd>{{ val }}</dd>
  {% endif %}
{% endfor %}
</dl>

Relationship to Custom Attributes

Custom Attributes are legacy unstructured key/value pairs stored directly on the product. Product Attributes are the preferred system — typed, reusable, filterable, and scoped to product or variant level. Both systems can coexist. Custom Attributes are available under the Custom Attributes tab; Product Attributes under the Attributes tab.

Get Started

Essentials

Analytics & Metrics

Funnels

Page Events

Pages

Merchants

Affiliates

Integrations

Members Area

Forms & Data

Subscriptions

Emails

Products & Sales

Domains & Customization

Development & Debugging

Frontend Template Engine

Backend Template Engine

CRM

Backend Scripts

Managing Attribute Definitions

Field Types

Applies To Scoping

Assigning Values to Products

Template Access

List Definitions

Get Product Values

Shorthand Filters

Full Display Example

Relationship to Custom Attributes

​Managing Attribute Definitions

​Field Types

​Applies To Scoping

​Assigning Values to Products

​Template Access

​List Definitions

​Get Product Values

​Shorthand Filters

​Full Display Example

​Relationship to Custom Attributes

Managing Attribute Definitions

Field Types

Applies To Scoping

Assigning Values to Products

Template Access

List Definitions

Get Product Values

Shorthand Filters

Full Display Example

Relationship to Custom Attributes