Documents

Import a List of Attributes

Last Modified Dec 9, 2025

This feature allows you to upload and import a bulk list of attributes for the products into the store's catalog. By using a CSV file, you can quickly add multiple attribute rows.
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 attributes list you must:

  1. Navigate to Taxonomy > Attributes in the main menu.
  2. Click [ v ] at the right of the Create button.
  3. Click on Import.
"

You can click on the cloud icon to download a File Sample.

  1. 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.
  2. 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 attributes, 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 attributes.

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:

  • code: unique code of the attribute.
  • title: text that will appear as a label.
  • description: brief description of the attribute.
  • type: available types are 'Text', 'Number', 'List' and 'Yes / No'.
  • searchable: 'yes' if the attribute is searchable
  • filterable: 'yes' if the attribute is filterable
  • sortable: 'yes' if the attribute is sortable
  • options: A comma-separated list of option names that can be assigned to the attribute when the type is 'List'. Each option will generate a code by removing special characters and replacing spaces with dashes from the option name. If a custom code is required, you can specify a name-code pair using a colon as the separator (name:code).


← Add a new Attribute
Attribute Families Overview →