> For the complete documentation index, see [llms.txt](https://docs.globo.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.globo.io/swatch/product-groups/import-product-groups-by-csv.md).

# Import product groups by CSV

Create many groups at once from a spreadsheet.

Building dozens of groups by hand is slow. The importer creates and updates them from a single file.

## Import

1. Go to **Product Groups** and click **Import CSV**.
2. Click **Download sample CSV** and use it as your template — it shows exactly which columns the importer expects.
3. Fill it in, drop it into **CSV file**, and click **Import**.

<figure><img src="https://3138853960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDsbeTbRNMPUo58YEXkMj%2Fuploads%2Fgit-blob-9064964e539a668f8458ca25d9643e79c1786610%2Fproduct-groups-import-csv.png?alt=media" alt="The Import product groups by CSV window with its drop zone and the Download sample CSV link"><figcaption><p>Start from Download sample CSV so your columns match what the importer expects.</p></figcaption></figure>

## Watching the import

Imports run in the background, so you can leave the window open and watch:

* **Status** — where the import is up to.
* **Rows** and **Groups** — how much has been processed.
* **Created**, **Updated**, **Skipped groups** and **Missing handles**.

When it finishes you get a summary of what was created, updated and skipped. If any rows had problems, an **Import warnings** panel lists them by row number.

## Things to watch

* Products are matched by their Shopify handle. **Missing handles** means a row referenced a handle that doesn't exist in your store — check for typos or unpublished products.
* Only one import can run at a time. If one is already going, the app asks you to wait for it to finish.
* Re-uploading an identical file is rejected: update the file before importing it again.

## Related pages

* [Create a product group](/swatch/product-groups/create-a-product-group.md)
* [Product groups overview](/swatch/product-groups/overview.md)