Documents
Import a List of Categories
Last Modified Dec 9, 2025
This feature allows you to upload and import a bulk list of categories. By using a CSV file, you can quickly add multiple categories.
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 a categories list you must:
- Navigate to Taxonomy > Categories in the main menu.
- Click [ v ] at the right of the Create button.
- Click on Import.
- Select the CSV file from your disk and click Ok. After uploading the file, the message will be displayed:
"my_categories_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 categories, 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 categories.
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: name of the category.
- description: brief description of the category
- urlKey: following the rules of the URL Keys defined here
- position: the position in which the category will appear in the store.
- parent: the URL Key of the category under which it will be a subcategory.