Documents
Import a List of Attribute Families
Last Modified Dec 9, 2025
This feature allows you to upload and import a bulk list of attribute families for the products into the store's catalog. By using a CSV file, you can quickly add multiple families.
A CSV is a simple plain text file. Each line in a CSV file represents a row of data, with individual values separated by commas.
To upload an attribute families list you must:
- Navigate to Taxonomy > Attribute Families in the main menu.
- Click [ v ] at the right of the Create button.
- Click on Import.
You can click on the cloud icon to download a File Sample.
- Select the CSV file from your disk and click Ok. After uploading the file, the message will be displayed:
my_attributes_file.csv file uploaded successfully. - Once the file is processed, an alert will appear at the top, over the bell icon, allowing you to view the results of the process.
If you haven't received the notification that the import has finished, you can check the current status by navigating to Administration > Import Processes from the main menu. Find the activated import process to view its progress and status.
Structure of the CSV file
To import a set of attribute Families, the CSV file should have the following structure:
- The first line is a comma separated list of fields or columns
- The following lines are the attribute families.
Import format details:
- Empty rows are ignored.
- Empty columns are ignored.
- The first row with data is taken as the headers row.
- Field headers are flexible supporting:
- Case insensitive. For example: "Tax Code", "tax code", "TAX CODE", "tAX cODe" are equivalent.
- Non letter or digit characters are accepted but removed. For example: "Tax Rate", "Tax-Rate", "Tax_Rate", "Tax Rate %", "TaxRate" are equivalent.
- Unknown headers are ignored.
The available columns are:
- name: text that will identify the attribute family.
- attributes: comma separated set of attribute codes, defining the attributes the family will contain.