Documentation

Product Attributes

Keep a list of attribute types such as size, cut or colour, and know what that list does and does not do today.

You do this in the Web admin under Inventory > Product Attributes. The screen is titled Product Attribute Types. You need permission to view products.

Attribute types do not create variants

This screen only stores the list of attribute types. There is no screen where you attach an attribute to a product or a variant, and variants are not generated from attributes. Nothing here changes products, stock, purchasing or the POS. Variants are added by hand on a product's Variants tab: see Products. Use this list if you want to prepare the attributes you intend to use; otherwise you can skip it.

The Product Attribute Types list

Product Attribute Types list with search, data type filter, sort and page size controls, the Add New Attribute Type button, and an empty table
The Product Attribute Types screen on a new account: no attribute types yet

The table shows Order, Attribute Name, Code, Data Type (for a List type, the first few values appear under it), Required (Required or Optional), Active and Actions. Above it you can type in Search attribute types..., filter by data type (All Data Types, Text, Number, Date, Boolean, List), sort by Display Order, Name, Code or Created Date, choose the page size, and click Apply.

Add an attribute type

Create Product Attribute Type form with Attribute Name, Attribute Code, Data Type, Display Order, Applies To (Category), Description, Possible Values and the Is Required, Allow Multiple Values and Active boxes
Creating an attribute type called Cut with the List data type. Possible Values appears only for List
  1. Click Add New Attribute Type
    The Create Product Attribute Type form opens.
  2. Enter the Attribute Name and Attribute Code
    Both are required and must not be used by another attribute type. The name can be up to 100 characters and the code up to 50, for example Size and SIZE.
  3. Choose the Data Type
    See the table below. If you choose List, a Possible Values box appears: type one value per line. Possible values are required for the List data type.
  4. Fill in the optional fields
    • Display Order: a number used to sort the list.
    • Applies To (Category): free text naming the category this attribute is meant for. Leave blank to mean all products. It is a note only; it is not linked to your category list.
    • Description: up to 500 characters.
    • Is Required, Allow Multiple Values and Active: stored with the attribute type and shown in the list.
  5. Click Create
    The attribute type appears in the list.

Data types

Data Type Meant for
Text Free text, such as a material.
Number A number, such as a weight or a size in centimetres.
Date A date.
Boolean Yes or no.
List One of a fixed set of values that you type in Possible Values, such as Small, Medium, Large.

Edit or delete an attribute type

Use the pencil on a row to open Edit Product Attribute Type; it has the same fields, and Save Changes saves them. Use the bin to delete, then click Delete in the Confirm Delete dialog.

Troubleshooting

"The specified attribute name already exists." or "The specified attribute code already exists."

Another attribute type has that name or code. Search the list for it and edit that one, or choose a different name or code.

"Possible values are required for List data type"

You chose List but left Possible Values empty. Type at least one value, one per line, or choose another data type.

Related pages

Products

Add variants on the product's Variants tab.

Product Units and Packaging

Boxes, packs and bags are units on the product, not attributes.