How to import attribute groups using a CSV file?
These instructions will help you add or update attribute sets in CSV format quickly and correctly.
Attribute Set import is not available
In the current AI Commerce admin, Attribute Set definitions cannot be created or updated with a CSV import. Manage Attribute Sets under PIM > Attribute Sets. You can export the sets to CSV for review and planning, but the exported file cannot be imported back as Attribute Set definitions.
Create and edit an Attribute Set
- Open PIM > Attribute Sets.
- Select New attribute set or open an existing set.
- Enter a permanent Code, the Sort order, and the required localized labels.
- Under Assigned attributes, choose an attribute from Select an attribute and select Add attribute.
- Order attributes with Move up and Move down. Remove a membership with Remove attribute.
- Select Save set.
An attribute must belong unambiguously to exactly one Attribute Set before it can be used in Family memberships and Families CSV imports.
Export Attribute Sets to CSV
- Open Data Exchange.
- Select the Attribute set export profile.
- Run the export and download the completed CSV file.
The export produces one row for each Attribute Set. The CSV contains these fields:
-
code: the unique Attribute Set code. -
title[<language_code>]: the set label in each active data language. -
attributes: comma-separated attribute codes assigned to the set. -
sort_order: the set's numeric sort order.
The CSV is a snapshot of the current state. Editing the file does not change Attribute Sets in AI Commerce.
When should I use Families import?
To update the attribute memberships or per-channel required attributes of an existing Family, use the Data Exchange > Families import profile. It does not create Attribute Sets or change their codes, labels, sort order, or attribute ordering.
The attributes field in a Families CSV is the complete list of Family attribute memberships. Each requirements-<channel_code> field is the complete list of required attributes for that channel.
Families import replaces the lists
A Family membership or channel requirement omitted from the import is removed. Always preview the import before running it and include every value that must remain.
Summary
- Create and edit Attribute Sets under PIM > Attribute Sets.
- Attribute set export writes the current Attribute Set state to CSV.
- There is no CSV import for Attribute Set definitions.
- Families import is a separate operation for memberships and per-channel requirements on existing Families.