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

# Bulk create Product Groups

Instead of building [Product Groups](/swatch/product-groups/show-separate-products-as-variants-with-product-groups.md) one by one, scan your catalog and create many groups at once from a shared pattern.

## Group by

<table><thead><tr><th width="180">Mode</th><th>How it groups products</th></tr></thead><tbody><tr><td><strong>Product name pattern</strong></td><td>Products whose titles share a common pattern are grouped together</td></tr><tr><td><strong>Product tag</strong></td><td>Products are grouped by tag, using one of three rules (see below)</td></tr><tr><td><strong>Product metafield</strong></td><td>Products sharing the same value in a metafield you pick (or type a namespace/key for) are grouped together</td></tr></tbody></table>

For **Product tag**, choose one rule:

* **One group per tag** — every tag becomes its own group.
* **One group, any of the tags** — a single group containing any product with at least one of the selected tags.
* **One group, all of the tags** — a single group containing only products with every selected tag.

You can also add a Shopify search query to narrow down which products are scanned before grouping.

## How it works

{% stepper %}
{% step %}

#### Go to **Product groups** → **Bulk create**

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FuLzG8llVG3b99Aorpmr5%2Fimage.png?alt=media&amp;token=f6a7d28a-6511-4d79-aad8-1b08be860a96" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Pick a **Group by** mode and set its options

Optionally narrow the scan with a search query.
{% endstep %}

{% step %}

#### Review the **preview**

Each group the scan would create is listed. Groups whose name already matches an existing group are marked **already exists** and skipped automatically. Uncheck any group you don't want to create.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FMuXvrdYQqaKGOUsp10bn%2Fimage.png?alt=media&amp;token=090a24fb-df2a-4c20-88ac-fb5c63f5da8b" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Click **Create** to save the checked groups

{% endstep %}
{% endstepper %}

## Limits

<table><thead><tr><th width="220">Limit</th><th>Value</th></tr></thead><tbody><tr><td>Products scanned for the preview</td><td>Up to 250 products</td></tr><tr><td>Products in a single group</td><td>Up to 2,000</td></tr><tr><td>Groups created per bulk-create run</td><td>Up to 100</td></tr></tbody></table>

{% hint style="info" %}
If your catalog is larger than these limits, narrow the scan with a search query and run bulk create again for the remaining products.
{% endhint %}