WooCommerce · Info
Can You Import WooCommerce Attributes? The Short Answer

Short answer
Yes. The built-in WooCommerce product CSV importer brings in attributes with each product, using columns for the attribute name, values, visibility and global setting. To import attributes or terms without products, use an import plugin, the WooCommerce REST API or WP-CLI commands.
Key takeaways
- The core CSV importer handles attributes inside product rows.
- Set the global column to 1 to use shared, filterable attributes.
- Variations need a Parent column matching the parent SKU.
- Attribute-only imports need a plugin, the REST API or WP-CLI.
- Consistent spelling prevents duplicate attributes and terms.
Can you import WooCommerce attributes?
Yes, the built-in WooCommerce product CSV importer brings in attributes as part of each product, and plugins, the REST API or WP-CLI can import attributes and their terms on their own.
The key detail is that the core importer is product-based. Attributes ride along inside product rows, using columns such as Attribute 1 name and Attribute 1 value(s).
There is no separate core screen for uploading a list of attributes without products. For that, you need a plugin, a script using the REST API, or command-line tools.
Below is how each route works, what the CSV columns mean, and the mistakes that cause attributes to import incorrectly.
How does the WooCommerce CSV importer handle attributes?
Each product row can carry several attributes, numbered 1, 2, 3 and so on, with columns for the name, the values, whether it is visible, whether it is global, and a default for variable products.
WooCommerce's documentation for the product CSV importer and exporter lists every supported column.
Here are the attribute columns you will use most:
| Column | What it holds | Example |
|---|---|---|
| Attribute 1 name | The attribute label | Color |
| Attribute 1 value(s) | One or more values, comma separated | Red, Blue, Green |
| Attribute 1 visible | 1 to show on the product page, 0 to hide | 1 |
| Attribute 1 global | 1 for a global attribute, 0 for a custom one | 1 |
| Attribute 1 default | Default choice on a variable product | Blue |
Add a second attribute with Attribute 2 name, Attribute 2 value(s) and so on. You can keep adding numbered sets as needed.
The importer runs from Products > All Products > Import. You upload the file, map columns, and WooCommerce creates or updates products.
What is the difference between global and custom attributes?
Global attributes are shared across your store and managed under Products > Attributes, while custom attributes exist only on one product and cannot be used for layered filtering.
Global attributes are stored as taxonomies. That lets you filter products by color or size and reuse the same terms on many products.
Custom attributes are just text saved on a single product. They are fine for one-off details but harder to manage at scale.
In the CSV, set Attribute 1 global to 1 to use a global attribute. When the attribute name matches an existing global attribute, the values attach to it as terms.
WooCommerce explains global attributes in its guide to managing product taxonomies. It is wise to create your main global attributes first, then import products that use them, so names match exactly.
How do you import attributes for variable products?
Import the parent product with all attribute values and a type of variable, then import each variation as its own row with a Parent column pointing to the parent SKU and a single value for each attribute.
Variable products need two kinds of rows:
- Parent row: Type is
variable. The attribute values list every option, such asS, M, L. Mark the attribute as used for variations if your file includes that column. - Variation rows: Type is
variation. The Parent column holds the parent's SKU. Each attribute value holds one option, such asM, plus the variation's own price and stock.
The easiest way to get the format right is to create one variable product by hand, export it, and copy the structure.
Our guide on exporting WooCommerce products shows how to export a sample file with the exact columns your store uses.
If you show colors or sizes as visual buttons, the swatch plugin usually reads the same global attributes. Our explainer on variation swatches for WooCommerce covers how that works.
Can you import attributes without products?
Not with the core importer, but you can create attributes and terms in bulk with an import plugin, the WooCommerce REST API, or WP-CLI commands.
This is useful when you want to set up a full list of attributes and terms before adding products, for example 40 colors and 15 sizes.
Your main options:
- Import plugins: Tools like WP All Import can import taxonomy terms, and WooCommerce add-ons extend this to products. Check which features need a paid add-on.
- REST API: The WooCommerce REST API documentation includes endpoints for product attributes and attribute terms, so a developer can create them from a script.
- WP-CLI: WooCommerce adds commands to WP-CLI that map to the REST API. The WC-CLI overview explains how they work.
Using the API needs keys with write permission. Our guide on getting a WooCommerce API key explains how to create them safely.
How do you prepare a CSV file for attributes?
Start from an exported sample file, keep the column headers exactly as WooCommerce expects, use consistent spelling for attribute names and values, and save the file as UTF-8 CSV.
Small inconsistencies cause most attribute problems. Colour and Color become two separate attributes, and Navy blue and Navy Blue can create two terms.
Follow these habits:
- Pick one spelling for each attribute name and stick to it.
- Separate multiple values with a comma and a space.
- Escape commas inside a value with a backslash, as the documentation describes.
- Save as UTF-8 so accented characters import cleanly.
- Test with five products before importing five thousand.
Spreadsheet apps sometimes change values, such as turning sizes like 10-12 into dates. Check the raw CSV in a text editor if values look odd after import.
What goes wrong when importing attributes?
Common problems are duplicate attributes from spelling differences, values importing as custom instead of global, missing variations because the Parent SKU does not match, and terms not showing in filters.
| Problem | Likely cause | Fix |
|---|---|---|
| Duplicate attributes | Name spelled differently in the CSV | Use the exact global attribute name |
| Values show as text only | Global column set to 0 | Set Attribute global to 1 |
| Variations missing | Parent SKU mismatch | Match the Parent column to the parent SKU |
| Wrong default option | Default value does not match a value | Copy the value exactly |
| Filters missing terms | Custom attributes used | Convert to global attributes |
When the import finishes, WooCommerce shows a summary with skipped or failed rows. Read it before running more imports.
Always back up before a big import. Rolling back hundreds of half-imported products by hand is slow. Our guide on backing up a WooCommerce store covers the safest options.
Can you update attributes on existing products with an import?
Yes, tick the option to update existing products in the importer, then match products by ID or SKU, and the attribute columns in your file will replace the current attribute data.
This is handy for adding a new attribute, such as material, to a whole catalog at once.
Be careful with partial files. If your update file leaves out some attribute columns, test first to see how your version handles them, as you may lose data you meant to keep.
Run updates on a staging site first when possible. That way you can compare before and after without touching the live store.
Should you use the core importer or a plugin?
Use the core importer for standard product and attribute imports, and a plugin when you need scheduled imports, supplier feeds, attribute-only imports or complex field mapping.
The core tool is free, built in and works for most stores.
Plugins earn their place when you import from suppliers every day, map unusual file formats, or manage very large catalogs. If you need one, our guide on installing an import plugin walks through setup.
For product categories, which work in a similar way to attributes, see our guide on importing categories in WordPress.
Frequently asked questions
How do I bulk import attributes in WooCommerce?
Add attribute columns to a product CSV file and import it from Products > All Products > Import. To create attributes and terms without products, use an import plugin, the WooCommerce REST API or WP-CLI commands instead.
What are the attribute columns in a WooCommerce CSV?
The main ones are Attribute 1 name, Attribute 1 value(s), Attribute 1 visible, Attribute 1 global and Attribute 1 default. Add more attributes by repeating the set with the next number, such as Attribute 2.
Why are my imported attributes not global?
The global column was probably set to 0 or left out, or the attribute name did not match an existing global attribute. Set the global column to 1 and use the exact name shown under Products > Attributes.
Can I import product variations with attributes?
Yes. Import the parent as a variable product with all attribute values, then add variation rows with the Parent column set to the parent SKU and a single attribute value for each variation.
Can I export WooCommerce attributes?
The core exporter includes attributes as part of exported products. Exporting just the attribute list and terms needs a plugin, the REST API or WP-CLI, since there is no separate core export for attributes.
Sources
- Product CSV Importer and Exporter WooCommerce Docs
- Managing Product Categories, Tags and Attributes WooCommerce Docs
- WooCommerce REST API Documentation WooCommerce
- WC-CLI Overview WooCommerce on GitHub
- WP All Import WordPress.org Plugin Directory
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


