> 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/globo-combined-listings/product-groups/create-a-group/create-a-single-option-group.md).

# Create a single-option group

Use this when **one thing changes** between your products — like Color, scent, material, or pack size. Each value links to exactly one product. Not sure this is the right type? See [Group types](/globo-combined-listings/product-groups/group-types.md).

<figure><img src="/files/iJNNvGhjSZs1Mk1cQZhQ" alt="Single-option group editor with the live preview panel on the right"><figcaption><p>The single-option group editor, with a live storefront preview alongside.</p></figcaption></figure>

## Group details

The internal **Group name** (up to 255 characters) — used only inside the admin; *customers don't see this*. The field shows placeholder text like `Hoka Tecton X 3 — Women's` until you type your own.

## Options and values

Add **one option** (e.g. `Color`) and one value per product variation (e.g. `Red`, `Blue`, `Green`).

> *"Each value links to one of your products."*

* **Option name** — the label shoppers see (e.g. `Color`). Rename per language via the [storefront language switcher](/globo-combined-listings/product-groups/translations.md).
* **Values** — add, rename, and drag to reorder. Each value has a **swatch** that represents it visually:

| Swatch type      | What shows                                              |
| ---------------- | ------------------------------------------------------- |
| **First image**  | The linked product's first image.                       |
| **One color**    | A solid color you pick.                                 |
| **Two colors**   | A split two-color swatch (e.g. for dual-tone products). |
| **Custom image** | An image you upload.                                    |

> 📸 **Screenshot placeholder** — a value row with the swatch type dropdown open.

### Appearance

Each option chooses a style per surface — **On product page** and **On product card** — from your [style library](/globo-combined-listings/styles/style-library.md), or **Hidden** to skip that surface. New options come prefilled with your default styles, so picking a ready-made style that fits is usually all you need — **Customize** jumps into the [style editor](/globo-combined-listings/styles/customize-a-style.md) when you want finer control.

## Linking products

Each product row simply gets a value — pick which value (e.g. which color) that product represents.

<figure><img src="/files/sjoxPUbVEHUNcA6Xm2gx" alt="Product list with a value assigned to each row"><figcaption><p>Every linked product gets its own value name and swatch type.</p></figcaption></figure>

The product picker searches your catalog with infinite scroll, and disables archived products and products already in another group. A value with no product linked leaves the group [incomplete](/globo-combined-listings/product-groups/product-groups.md#complete-vs-incomplete).

## Live preview

A sticky preview pane renders your actual widget with tabs for **Product page** and **Product card**. It updates as you type and reflects the selected styles — what you see is what ships.

## Saving and publishing

* **Publish group** (create) / **Save group** (edit) — the primary action.
* **More actions** menu: **Set as active**, **Set as draft**, **Delete**.
* A save bar guards unsaved changes when you navigate away.

### Validation errors

If something is invalid (missing option name, duplicate value names, a product already taken…), the editor shows a critical banner at the top plus inline field errors, and scrolls to the first problem. Fix and save again.

<figure><img src="/files/uiSZyLNbLnacjdcxUU7l" alt="Group editor validation banner with an inline field error"><figcaption><p>Fix the flagged fields — the banner and inline errors point to exactly what's missing.</p></figcaption></figure>

{% hint style="info" %}
After saving, storefront data syncs in the background — allow a minute or two before checking your live store.
{% endhint %}

## Next

* Manage it from the [Groups index](/globo-combined-listings/product-groups/manage-groups.md).
* Wrong type after all? See the other guides: [multiple options](/globo-combined-listings/product-groups/create-a-group/create-a-multiple-options-group.md) · [single choice](/globo-combined-listings/product-groups/create-a-group/create-a-single-choice-group.md).