> 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](https://docs.optis.me/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.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FYNEEC53ez92iAjQzdHS2%2FScreenshot%20(20).png?alt=media&amp;token=ddb19c0c-3cca-441f-9a6b-c62dcb2b683d" alt=""><figcaption></figcaption></figure>

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%2FaBBn23P4eHzoqUsU9P2g%2FScreenshot%20(22).png?alt=media&amp;token=d3f9065d-7208-4bac-a67b-4992ece191a7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

Optionally narrow the scan with a search query.

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2F1XYLoMDcrQrivygVB0qJ%2FScreenshot%20(21).png?alt=media&amp;token=3ce6f9ab-c3b5-415c-9034-85892efb9e71" alt=""><figcaption></figcaption></figure>
{% 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%2Fgit-blob-cc79264a75ab051439e43c6920deb0f73a6f9d98%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

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

<figure><img src="https://4026661835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50cmOdvfYj3qqQaTzKEI%2Fuploads%2FnSiMBAaGS6j8WdDW3wg9%2FScreenshot%20(23).png?alt=media&amp;token=b3bc6b92-77a7-4a66-b926-f2f6d18aa6fe" alt=""><figcaption></figcaption></figure>
{% 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 %}
