prduct.com has many pre-defined attributes, but in some cases you will want to define your own.
How to create a new custom attribute?
Go to the Data tab and open the Data models tab.
Scroll down to the All custom attributes heading. Here you can see, edit, and delete all your existing custom attributes.
Click the green Create Custom attribute button. This takes you to the create custom attribute page.
Fill in the basic information:
Display name – the name shown for the attribute in the system.
System name – auto-generated from the display name, but can be edited manually. This is only used for API and other integrations — it's the JSON name used in the background.
Description – optional. Add an explanation of what the attribute is for.
Under Document availability, select which document types the attribute should be available on. If the attribute should only be used on, for example, products, select only Products. If you want to reuse the same attribute across multiple document types — for example a list of materials relevant both on product level and component level — select both.
Use the Localized slider to decide whether the attribute should support translated layers. When enabled, the value of the attribute can vary depending on the selected language/market. Attributes such as weight or other data that don't change between markets should stay non-localized, while attributes like descriptions or other explanatory text will typically vary from language to language.
Below Localized, you can enable Read only. If enabled, the value of the attribute can only be updated via the API — it cannot be edited manually.
Select the Data type for the attribute. There are 16 data types available (e.g. Number, Text, Date, Phone, File), and each comes with slightly different functionality:
Select – use this if you want a list of multiple choices.
File – use this if the attribute should hold a specific file type.
Complex – use this to build an attribute made up of several sub-attributes, for example a Contact attribute containing Name, Address, Phone number, and Email.
SmartFields – use this to create an attribute based on a mathematical expression, where you can multiply, add, or subtract other attribute values. For example, you can multiply a Quantity attribute with a Weight attribute to calculate the total weight of a batch.
Depending on the data type you choose, further settings will appear below, such as:
Selecting a unit to be displayed with the attribute.
Setting how many decimals the attribute should allow.
Allowing multiple values, so the attribute can hold several entries.
Setting the maximum length of the data in the attribute.
For File attributes: which file types are allowed, and attaching an example file.
When you are done, click Create to create your attribute.
What happens after the attribute is created?
Once created, the attribute appears on the Data models page under All custom attributes, where you can edit or delete it at any time.
You can now add the attribute to the document types you selected, or as part of a data model. See the Data models guide for more on how to work with data models.
How to create multiple custom attributes at once
You can mass-create/upload new custom attributes (just like you can with products, etc.). Please note: When using this method, you cannot create complex attributes with more than one field, and you cannot create the "select" field.
How to upload:
Click your name in the top-left corner and go to "My organization".
Go to the Data Settings tab.
Find the "CSV Import Attributes" button and click it.
The import pop-up will now appear. Here you'll find an example CSV file, which we recommend you use as a template.
Once the CSV file is ready, upload it and map the columns.
How to fill out the template:
We recommend using this template (which can also be found in the pop-up in the system).
Below is a list of the columns with explanations and input options: