Skip to main content
A Product custom field captures attributes specific to your catalog: hectares for an agricultural product, a certification level for a regulated good, or a technical capacity for industrial equipment. Product custom fields are stored per variant, so each variant can carry its own value.
You need the Data permission in the Settings block of your role to create fields. See Manage roles.

​
What you’ll build

​
Step 1: Create the field in the Data Model

1

Open Data Model

Go to Settings › Data › Data Model and click the Products object.
2

Click + New

In the top right of the field list, click + New to open the field creation form.
3

Fill in General Information for Hectares

  • Name: Hectares
  • API Name: for example hectares. It can’t be changed after creation.
  • Data Type: pick Number
4

Save and repeat

Click Save, then create Certification level with type Text the same way.
Two new fields appear in the Products field list with the Custom badge.

​
Step 2: Fill the fields on your products

1

Open a product

Go to Products & pricing › Products and open a product (or create one).
2

Open the Attributes tab

Click the Attributes tab and find the Custom fields section.
3

Activate and fill the fields

Turn on the toggle of each field you want to use on this product, then enter the value: Hectares = 0.5, Certification level = Organic.
4

Save the product

Click Save.
For a product with variants, open each variant page to set its own values in the same Custom fields section.
Product custom fields only have a toggle and a value. The Mandatory, Editable by sale, and Display for customer properties are available on customer and template custom fields. Product custom fields aren’t part of the CRM field synchronisation.

​
Fill the fields by CSV

To set values on many products at once, use the Products import. Name each column custom[<api_name>], for example custom[hectares]. The column maps automatically when the API name exists in your data model.

​
Common Product custom fields

​
Troubleshooting

Refresh the page after creating the field. Check that you created it on the Products object, and look in the Attributes tab.
Check that the column header is custom[<api_name>] with the field’s API Name exactly, and that the column is mapped at the Mapping step.

Field types

Pick the right type for your product attribute.

Import products

Bulk-fill custom fields via CSV.

Products

Manage your catalog of products.

Objects

Which objects accept custom fields.
Last modified on October 27, 2026