Import Attributes

Overview

Import Attributes bulk-creates attributes from a JSON file. It’s the fastest way to set up many attributes at once — for example when migrating from another system. Download the ready-made template, fill in your attributes, and upload the file.

Navigation

Sidebar: Attributes → Import Attributes URL: /admin/product-attributes/import

File format

Attribute import accepts JSON only. You can upload a .json file or paste JSON directly. The file contains an array of attribute objects; you can also choose whether to update existing attributes that match by code.

Download Import Template

Use Download Import Template to get a ready-made example file named product_attributes_template.json. It contains sample attributes you can edit or replace, and shows every supported field.

Each attribute object supports these keys:

Key	Description
name	Internal attribute name
label	Label shown on forms
code	Unique code (a–z 0–9 _)
type	int, boolean, option, big_text, or short_text
value	For option, the selectable options; otherwise null
position	Display order
language	Optional language code
required	true / false
searchable	true / false
visible	true / false
editable	true / false

The template includes sample rows such as an Option attribute (product_color) with its options, an Integer attribute (product_weight), and a Long Text attribute (product_description).

Note

For Option attributes, the options are stored inside the attribute’s value field (for example { "options": [ { "value": "red", "label": "Red" } ] }). The importer creates the attribute with its options in one step.

How to import attributes

To bulk-import attributes, download the JSON template, fill in your attribute definitions, and upload the file.

1. Open Attributes → Import Attributes.
2. Select Download Import Template and edit product_attributes_template.json with your attributes.
3. Upload the file (or paste the JSON).
4. Choose whether to update existing attributes that match by code.
5. Run the import and review the results.

Results & validation

Each attribute is matched by code within your organization:

• New code → the attribute is created.
• Existing code → updated if “update existing” is enabled, otherwise skipped.
• Invalid rows are reported individually.

The import returns a summary of created, updated, skipped, and errors. Imported attributes are marked with the source Imported.

Actions

• Download Import Template — get the example JSON file
• Upload File / Paste JSON — provide your attributes
• Import — create or update attributes
• Review Results — see created, updated, skipped, and error counts

Related

• Attribute List — the five attribute types
• Attribute Properties — what each field means
• Add Attribute — create a single attribute manually
• Attribute Groups — organize imported attributes for the product editor