Attribute Set

Attribute sets are used to group attributes into groups that are easily identifiable.

For example T-shirt could be an attribute set that has color and size as attributes. Further more, these attribute sets are used to easily select groups of products.

Thus, where attribute groups are about grouping attributes, attribute sets are about grouping products.

Every product can only belong to one product attribute set.
A car will never be a ship. You can however fine-tune attribute sets to your liking. For example, instead of a general-purpose attribute set called car, you can make a more specific attribute set called Volvo.

Attributes

In order to best explain attributes, we can use a single product as an example. Let's say we have a product, which is a t-shirt called "Awesome T-shirt".
We would like to register some of its properties, so we can display those in our store.

We'll start with the following:

• Color
• Gender
• Size

Those are called attributes. Thus, we can set up an attribute set called T-shirt and assign these three attributes to it.
The actual value for each attribute of the Awesome T-shirt is called a property.

Consequently, the "Awesome T-shirt" is part of the T-shirt attribute set, in which we can register Color, Gender and Size.
The actual values for those attributes, for example Red, Female and Medium, are the properties of our product.

Attributes can be reused across attribute sets, e.g. a sweater is a different attribute set, but it can also have a size attribute.

Attribute Types

We have five different types of attributes:

• number
• boolean
• select*
• multiselect**
• string (text)

*For example, you have the quality attribute and you want to give it a fixed list of options.
**For example, the colour attribute, where you can select more than one option.

Attribute options

Attribute options are the possible values of attributes.
For example: if size has a specific set of possible values (Small, Medium, Large, etc.), every one of these values would be an attribute option.
Attribute options are only needed if the attribute can be defined this way. Price, for example, cannot reasonably be defined as a set of possible values when working with many products. Price would be a free field, accepting a string or int types as values.

Attribute groups

Grouping of attributes is used to create a logical grouping of...... you guessed it attributes.
For example let's say you want to give a product dimensions, so you create a width attribute, length etc. Grouping them together in a group 'dimensions' makes sense.

API calls

Endpoint: /attribute-sets

{
    name*: string
}

{
    name: string
}

{
    property_id*: int^,
    value
}

Endpoint: /product-attribute

{
    "name*": string,
    "code*": string,
    "input_type*": number|select|multiselect|boolean|text|list,
    "productattributegroup_id*": integer,
    "options": array
}

{   
    productattributegroup_id*: int|(productattributegroup/id)**,
    code*: (productattribute/code)~,
    name*: string,
    inputtype: [
        'number', 
        'select', 
        'multiselect', 
        'boolean', 
        'text', 
        'list'
    ],
    options: array
}

Endpoint: /product-attribute-option

{
    value*,
    code,
    default*: boolean
}

{
    value*,
    code,
    default*: boolean
}

Endpoint: /product-attribute-group

{
    "name*": string,
    "sort_order": integer,
    "default": boolean
}

{
    name: (productattributegroup/name)~,
    sort_order: int,
    default: boolean,
}