Saleor Attributes
Before writing code
Fetch live docs:
- Fetch
https://docs.saleor.io/developer/products/overview for product and attribute overview
- Web-search
site:docs.saleor.io attribute types DROPDOWN MULTISELECT NUMERIC for attribute type reference
- Web-search
site:docs.saleor.io product type attributes variant selection for product type configuration
- Web-search
site:docs.saleor.io attribute filtering products for attribute-based filtering
- Web-search
site:docs.saleor.io page types attributes for content page attributes
Attribute System Overview
Saleor uses a typed attribute system to define flexible product schemas without database migrations. Attributes are attached to product types and page types, providing structured metadata for products, variants, and content pages.
| Concept |
Purpose |
| Attribute |
A named, typed field (e.g., "Color", "Size", "Material") |
| Attribute value |
A specific value for an attribute (e.g., "Red", "XL", "Cotton") |
| Product type |
A template that defines which attributes a product has |
| Page type |
A template that defines which attributes a content page has |
| Variant selection attribute |
An attribute used to distinguish product variants |
Attribute Types
| Type |
Input |
Storage |
Use Case |
DROPDOWN |
Single select from predefined values |
String reference |
Color, brand, material |
MULTISELECT |
Multiple select from predefined values |
String references |
Features, tags, certifications |
RICH_TEXT |
Rich text editor (JSON) |
JSON (EditorJS) |
Long descriptions, care instructions |
PLAIN_TEXT |
Simple text input |
String |
Short notes, SKU prefix |
NUMERIC |
Number input with optional unit |
Decimal |
Weight, dimensions, capacity |
BOOLEAN |
True/false toggle |
Boolean |
Is organic, is fragile |
DATE |
Date picker |
Date |
Expiry date, release date |
DATE_TIME |
Date and time picker |
DateTime |
Event time, availability window |
FILE |
File upload |
File reference |
Spec sheets, certificates |
REFERENCE |
Reference to another entity |
Entity ID |
Related product, linked page |
SWATCH |
Color swatch (hex or image) |
String + optional image |
Visual color selection |
Product Types
A product type defines the schema for a group of products:
| Product Type Field |
Purpose |
name |
Product type name (e.g., "T-Shirt", "Laptop") |
productAttributes |
Attributes shown on the product level |
variantAttributes |
Attributes that define variant differences |
isShippingRequired |
Whether products of this type need shipping |
isDigital |
Whether products are digital downloads |
taxClass |
Tax classification for products of this type |
weight |
Default weight for products of this type |
Product Attributes vs Variant Selection Attributes
| Category |
Scope |
Example |
| Product attributes |
Same for all variants of a product |
Brand, material, care instructions |
| Variant attributes (non-selection) |
Per variant, but not for customer selection |
Internal SKU code |
| Variant selection attributes |
Per variant, presented to the customer for selection |
Size, color |
Variant selection attributes generate the variant picker on the storefront (e.g., size/color dropdowns).
Attribute Values
| Value Aspect |
Detail |
| Predefined |
Created in advance for DROPDOWN, MULTISELECT, SWATCH types |
| Dynamic |
Entered per product for PLAIN_TEXT, RICH_TEXT, NUMERIC, DATE types |
| Sortable |
Values can be reordered within an attribute |
| Translatable |
Values support multi-language translations |
| Slug |
URL-safe identifier auto-generated from the value name |
Rich Text Values
Rich text attributes use the EditorJS JSON format:
| Block Type |
Purpose |
paragraph |
Text paragraph |
header |
Heading (h1-h6) |
list |
Ordered or unordered list |
image |
Embedded image |
Page Types
Page types work like product types but for content pages (CMS):
| Page Type Field |
Purpose |
name |
Page type name (e.g., "Blog Post", "FAQ") |
attributes |
Attributes attached to pages of this type |
Content pages use the same attribute types as products, enabling structured content management without a separate CMS.
Attribute Input Types
The inputType field controls how an attribute is presented in the Dashboard:
| Input Type |
Attribute Types |
Dashboard UI |
DROPDOWN |
DROPDOWN |
Single-select dropdown |
MULTISELECT |
MULTISELECT |
Multi-select chips |
PLAIN_TEXT |
PLAIN_TEXT |
Simple text field |
RICH_TEXT |
RICH_TEXT |
EditorJS rich text editor |
NUMERIC |
NUMERIC |
Number input with unit selector |
BOOLEAN |
BOOLEAN |
Toggle switch |
DATE |
DATE |
Date picker |
DATE_TIME |
DATE_TIME |
Date and time picker |
FILE |
FILE |
File upload widget |
REFERENCE |
REFERENCE |
Entity search and select |
SWATCH |
SWATCH |
Color picker or image upload |
Filtering Products by Attributes
Attributes enable faceted navigation on the storefront:
| Filter Parameter |
Type |
Purpose |
attributes |
list |
Filter by attribute slug and values |
attributes.slug |
string |
Attribute identifier |
attributes.values |
string[] |
Attribute value slugs to match |
attributes.valuesRange |
object |
Numeric range filter (min/max) |
attributes.date |
object |
Date range filter |
attributes.dateTime |
object |
DateTime range filter |
attributes.boolean |
boolean |
Boolean attribute filter |
Faceted Navigation Pattern
| Step |
Action |
| 1 |
Query available attributes for the product type or category |
| 2 |
Display attribute values as filter options (checkboxes, sliders) |
| 3 |
Build attributes filter from user selections |
| 4 |
Pass filter to products query |
| 5 |
Update available filter values based on current selection (count-aware) |
Creating Attributes via GraphQL
| Mutation |
Purpose |
attributeCreate |
Create a new attribute with type and values |
attributeUpdate |
Modify attribute settings |
attributeDelete |
Remove an attribute |
attributeValueCreate |
Add a new value to an attribute |
attributeValueUpdate |
Modify an attribute value |
attributeValueDelete |
Remove an attribute value |
attributeReorderValues |
Change the sort order of values |
productTypeCreate |
Create a product type with attribute assignments |
productTypeUpdate |
Modify product type attribute assignments |
Attribute Creation Fields
| Input Field |
Required |
Purpose |
name |
Yes |
Display name |
slug |
No |
Auto-generated from name if omitted |
type |
Yes |
PRODUCT_TYPE or PAGE_TYPE |
inputType |
Yes |
One of the attribute input types |
values |
No |
Initial predefined values (for DROPDOWN, MULTISELECT) |
valueRequired |
No |
Whether the attribute must have a value |
isVariantOnly |
No |
Restrict to variant-level only |
visibleInStorefront |
No |
Whether the attribute is public |
filterableInStorefront |
No |
Whether the attribute appears in storefront filters |
filterableInDashboard |
No |
Whether the attribute appears in Dashboard filters |
availableInGrid |
No |
Whether the attribute appears in Dashboard product grid |
unit |
No |
Measurement unit for NUMERIC type |
Best Practices
- Use DROPDOWN for attributes with a fixed set of values (colors, sizes, brands)
- Use variant selection attributes only for attributes that the customer chooses (size, color)
- Keep product attributes for shared information that does not vary per variant (brand, material)
- Enable
filterableInStorefront only for attributes that make sense as customer-facing filters
- Use NUMERIC type with units for measurable properties (weight, length) to enable range filtering
- Create separate product types for structurally different products (clothing vs electronics)
- Use page types to model structured content (blog posts, FAQs) without a separate CMS
- Translate attribute names and values for multi-language storefronts
Fetch the Saleor attributes documentation for exact attribute type behaviors, product type configuration patterns, and filtering query syntax before implementing.
1---2name: saleor-attributes-23description: Work with Saleor's typed attribute system — attribute types, product types, page types, variant selection attributes, and attribute-based filtering. Use when defining product schemas.4allowed-tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch5metadata:6 source: https://skillmd.com/skills/orcaqubits/saleor-attributes-27---89# Saleor Attributes1011## Before writing code1213**Fetch live docs**:141. Fetch `https://docs.saleor.io/developer/products/overview` for product and attribute overview152. Web-search `site:docs.saleor.io attribute types DROPDOWN MULTISELECT NUMERIC` for attribute type reference163. Web-search `site:docs.saleor.io product type attributes variant selection` for product type configuration174. Web-search `site:docs.saleor.io attribute filtering products` for attribute-based filtering185. Web-search `site:docs.saleor.io page types attributes` for content page attributes1920## Attribute System Overview2122Saleor uses a typed attribute system to define flexible product schemas without database migrations. Attributes are attached to product types and page types, providing structured metadata for products, variants, and content pages.2324| Concept | Purpose |25|---------|---------|26| Attribute | A named, typed field (e.g., "Color", "Size", "Material") |27| Attribute value | A specific value for an attribute (e.g., "Red", "XL", "Cotton") |28| Product type | A template that defines which attributes a product has |29| Page type | A template that defines which attributes a content page has |30| Variant selection attribute | An attribute used to distinguish product variants |3132## Attribute Types3334| Type | Input | Storage | Use Case |35|------|-------|---------|----------|36| `DROPDOWN` | Single select from predefined values | String reference | Color, brand, material |37| `MULTISELECT` | Multiple select from predefined values | String references | Features, tags, certifications |38| `RICH_TEXT` | Rich text editor (JSON) | JSON (EditorJS) | Long descriptions, care instructions |39| `PLAIN_TEXT` | Simple text input | String | Short notes, SKU prefix |40| `NUMERIC` | Number input with optional unit | Decimal | Weight, dimensions, capacity |41| `BOOLEAN` | True/false toggle | Boolean | Is organic, is fragile |42| `DATE` | Date picker | Date | Expiry date, release date |43| `DATE_TIME` | Date and time picker | DateTime | Event time, availability window |44| `FILE` | File upload | File reference | Spec sheets, certificates |45| `REFERENCE` | Reference to another entity | Entity ID | Related product, linked page |46| `SWATCH` | Color swatch (hex or image) | String + optional image | Visual color selection |4748## Product Types4950A product type defines the schema for a group of products:5152| Product Type Field | Purpose |53|-------------------|---------|54| `name` | Product type name (e.g., "T-Shirt", "Laptop") |55| `productAttributes` | Attributes shown on the product level |56| `variantAttributes` | Attributes that define variant differences |57| `isShippingRequired` | Whether products of this type need shipping |58| `isDigital` | Whether products are digital downloads |59| `taxClass` | Tax classification for products of this type |60| `weight` | Default weight for products of this type |6162### Product Attributes vs Variant Selection Attributes6364| Category | Scope | Example |65|----------|-------|---------|66| Product attributes | Same for all variants of a product | Brand, material, care instructions |67| Variant attributes (non-selection) | Per variant, but not for customer selection | Internal SKU code |68| Variant selection attributes | Per variant, presented to the customer for selection | Size, color |6970Variant selection attributes generate the variant picker on the storefront (e.g., size/color dropdowns).7172## Attribute Values7374| Value Aspect | Detail |75|-------------|--------|76| Predefined | Created in advance for DROPDOWN, MULTISELECT, SWATCH types |77| Dynamic | Entered per product for PLAIN_TEXT, RICH_TEXT, NUMERIC, DATE types |78| Sortable | Values can be reordered within an attribute |79| Translatable | Values support multi-language translations |80| Slug | URL-safe identifier auto-generated from the value name |8182### Rich Text Values8384Rich text attributes use the EditorJS JSON format:8586| Block Type | Purpose |87|-----------|---------|88| `paragraph` | Text paragraph |89| `header` | Heading (h1-h6) |90| `list` | Ordered or unordered list |91| `image` | Embedded image |9293## Page Types9495Page types work like product types but for content pages (CMS):9697| Page Type Field | Purpose |98|----------------|---------|99| `name` | Page type name (e.g., "Blog Post", "FAQ") |100| `attributes` | Attributes attached to pages of this type |101102Content pages use the same attribute types as products, enabling structured content management without a separate CMS.103104## Attribute Input Types105106The `inputType` field controls how an attribute is presented in the Dashboard:107108| Input Type | Attribute Types | Dashboard UI |109|-----------|----------------|-------------|110| `DROPDOWN` | DROPDOWN | Single-select dropdown |111| `MULTISELECT` | MULTISELECT | Multi-select chips |112| `PLAIN_TEXT` | PLAIN_TEXT | Simple text field |113| `RICH_TEXT` | RICH_TEXT | EditorJS rich text editor |114| `NUMERIC` | NUMERIC | Number input with unit selector |115| `BOOLEAN` | BOOLEAN | Toggle switch |116| `DATE` | DATE | Date picker |117| `DATE_TIME` | DATE_TIME | Date and time picker |118| `FILE` | FILE | File upload widget |119| `REFERENCE` | REFERENCE | Entity search and select |120| `SWATCH` | SWATCH | Color picker or image upload |121122## Filtering Products by Attributes123124Attributes enable faceted navigation on the storefront:125126| Filter Parameter | Type | Purpose |127|-----------------|------|---------|128| `attributes` | list | Filter by attribute slug and values |129| `attributes.slug` | string | Attribute identifier |130| `attributes.values` | string[] | Attribute value slugs to match |131| `attributes.valuesRange` | object | Numeric range filter (min/max) |132| `attributes.date` | object | Date range filter |133| `attributes.dateTime` | object | DateTime range filter |134| `attributes.boolean` | boolean | Boolean attribute filter |135136### Faceted Navigation Pattern137138| Step | Action |139|------|--------|140| 1 | Query available attributes for the product type or category |141| 2 | Display attribute values as filter options (checkboxes, sliders) |142| 3 | Build `attributes` filter from user selections |143| 4 | Pass filter to `products` query |144| 5 | Update available filter values based on current selection (count-aware) |145146## Creating Attributes via GraphQL147148| Mutation | Purpose |149|----------|---------|150| `attributeCreate` | Create a new attribute with type and values |151| `attributeUpdate` | Modify attribute settings |152| `attributeDelete` | Remove an attribute |153| `attributeValueCreate` | Add a new value to an attribute |154| `attributeValueUpdate` | Modify an attribute value |155| `attributeValueDelete` | Remove an attribute value |156| `attributeReorderValues` | Change the sort order of values |157| `productTypeCreate` | Create a product type with attribute assignments |158| `productTypeUpdate` | Modify product type attribute assignments |159160### Attribute Creation Fields161162| Input Field | Required | Purpose |163|-------------|----------|---------|164| `name` | Yes | Display name |165| `slug` | No | Auto-generated from name if omitted |166| `type` | Yes | `PRODUCT_TYPE` or `PAGE_TYPE` |167| `inputType` | Yes | One of the attribute input types |168| `values` | No | Initial predefined values (for DROPDOWN, MULTISELECT) |169| `valueRequired` | No | Whether the attribute must have a value |170| `isVariantOnly` | No | Restrict to variant-level only |171| `visibleInStorefront` | No | Whether the attribute is public |172| `filterableInStorefront` | No | Whether the attribute appears in storefront filters |173| `filterableInDashboard` | No | Whether the attribute appears in Dashboard filters |174| `availableInGrid` | No | Whether the attribute appears in Dashboard product grid |175| `unit` | No | Measurement unit for NUMERIC type |176177## Best Practices178179- Use DROPDOWN for attributes with a fixed set of values (colors, sizes, brands)180- Use variant selection attributes only for attributes that the customer chooses (size, color)181- Keep product attributes for shared information that does not vary per variant (brand, material)182- Enable `filterableInStorefront` only for attributes that make sense as customer-facing filters183- Use NUMERIC type with units for measurable properties (weight, length) to enable range filtering184- Create separate product types for structurally different products (clothing vs electronics)185- Use page types to model structured content (blog posts, FAQs) without a separate CMS186- Translate attribute names and values for multi-language storefronts187188Fetch the Saleor attributes documentation for exact attribute type behaviors, product type configuration patterns, and filtering query syntax before implementing.