⚙️ Introduction

This job allows the creation and update of Product Attributes via CSV import.

You can:

Create and update attributes
Define attribute types (Text, Metric, Lists, etc.)
Mark existing attributes as inactive

📂 Import model

The CSV file must contain one row per Attribute.

📄
Template
You can use the following spreadsheet as a template to structure your import:
Attributes - Template

📋 Fields

Field	Definition	Required for creation	Required for update	Editable	Default Value
`Attribute Names`	Name of the attribute.	✅		✅
`Attribute Values`	List of values. Format: `value1\|\|value2`. For COLOR: `#hex\|label` (e.g. `#000000\|Black`)			✅
`Attribute External Id`	Unique external reference for the attribute.	✅	✅
`Attribute Type`	Type of attribute. `TEXT`, `LONG_TEXT`, `COLOR`, `LIST_METRIC`, `LIST_TEXT`, `LIST_COLOR`, `DATE`, `METRIC`, `NUMBER`	✅
`Attribute Multi`	Boolean for multiple selection (only for LIST types).			✅	FALSE
`Attribute Unit Type`	Unit category. `WEIGHT_METRIC`, `VOLUME_METRIC`, `LENGTH_METRIC`, `AREA_METRIC`, `WEIGHT_IMPERIAL`, `VOLUME_IMPERIAL`, `LENGTH_IMPERIAL`, `AREA_IMPERIAL`	☑️ (Required if type = METRIC or LIST_METRIC)		✅
`Attribute Unit`	Selected unit of measurement. See unit table below	☑️ (Required if type = METRIC)		✅
`Attribute Variant`	Defines if the attribute is used for variants.	✅		✅	FALSE
`Mark Attribute as Inactive`	Flag to deactivate the attribute.			✅	FALSE
`Attribute Stores External Id`	Store identifier. Only required in multi-store context.			✅

☑️
Conditionally required

Available units by Unit Type

Unit Type	Available units
Weight metric	`kg`, `g`, `mg`
Volume metric	`m3`, `L`, `cL`, `mL`
Length metric	`m`, `cm`
Area metric	`m2`
Weight imperial	`lb`, `oz`
Volume imperial	`gal`, `qt`, `pt`, `fl oz`
Length imperial	`yd`, `ft`, `in`
Area imperial	`ft2`

🧠 Key Business Rules

Data format

Decimal separator: Period (.).
Date format: DD/MM/YYYY.
Boolean format: TRUE or FALSE.
Value separator: Always use || to separate multiple values or stores within a single cell.

Metric management

When using type = METRIC or LIST_METRIC, both Attribute Unit Type and Attribute Unit must be correctly mapped according to the allowed values.

Immutability

The Attribute Type and Attribute External Id cannot be modified after the initial creation.

📌
Best Practices
✔️ Ensure Attribute External Id is unique.
✔️ Validate attribute type and unit combinations before importing.
✔️ Test your import on a staging environment before applying it to production.