This is the early access documentation preview for Custom Views. This documentation might not be in sync with our official documentation.

Product Selections

Manage individual assortments for multiple sales channels through Product Selections.

Composable Commerce offers Product Selections that let you manage your assortments or product catalogs for any of your sales channel, such as brand sites, regional shops, or brick-and-mortar stores.

The recommended workflow to use Product Selections is as follows:

Create Products and their Variants.
Create Product Selections.
Assign Products or Product Variants to a Product Selection.
Create a Store.
Assign the Product Selection to one or many Stores and activate it.
A maximum of 100 Product Selections can be configured for a Store.

If the default fields available for Product Selection configuration do not fit your business needs, Composable Commerce lets you extend the Product Selection model by use of the Custom Fields API. The Merchant Center provides support for such Custom Fields on Product Selection.

Add a Product Selection

Go to Products > Add Product Selection.
In the Add a Product Selection page, follow these steps:
1. In the General information section, follow these steps:
  - In the Product Selection name, enter a name for the Product Selection.
  - Optional: In the Product Selection key, enter a unique identifier that helps identify the Product Selection.
  - In the Product Selection Type, select an option:
    - Inclusion: allows all or selected Variants of Products to be available on a Store.
    - Exclusion: disallows all or selected Variants of Products from being available on a Store.
  The type cannot be updated after the Product Selection is saved.
2. Optional: If a Custom Field is defined for the Product Selection, select it from the drop-down in the Custom fields section, and depending on the field type, enter or select the value for it.
  Custom Fields are implemented using the Custom Fields API.
Click Save.

Include or exclude Products and Product Variants from a Product Selection

You can assign Products to multiple Product Selections. However, only Product Variants with a defined SKU can be assigned.

Go to Products > Product list and click the Product.
On the Product Selections tab, click Assign Variants to a Product Selection and follow these steps:
1. In the Product Selection column, select the Product Selection to add the Product to.
2. Optional: In the Product variant(s) column, depending on your current and future assortment management plans, select one of the available options:
  - If the selected Product Selection is of type Inclusion:
    - All variants (default): adds all SKUs to the Product Selection, and automatically includes future SKUs added to the Product.
    - Only the following variants: adds selected SKUs to the Product Selection, and prevents future SKUs added to the Product from being included automatically.
    - All variants with SKU values except: adds all Product Variants to the Product Selection except the selected SKUs, and automatically includes future SKUs added to the Product.
  - If the selected Product Selection is of type Exclusion:
    - All variants (default): excludes all SKUs to the Product Selection, and automatically excludes future SKUs added to the Product.
    - Only the following variants: excludes selected SKUs to the Product Selection, and prevents future SKUs added to the Product from being excluded automatically.
Click Save.
If a Product Selection is not assigned to a Store, your full product catalog will be available on the Store. To set up a Store’s assortment, see Assign a Product Selection to a Store.

Bulk-assign Products to a Product Selection

Go to Products > Product list and select the Products, by their checkboxes.
Click the Actions drop-down and select Bulk assign products to product selections.
On the Assign products to product selections page, follow these steps:
1. From the Product Selection drop-down, select a Product Selection.
2. In Product Variants column For the selected Products , select any of the following options depending on your current and future assortment management plans:
  - If the selected Product Selection is of type Inclusion:
    - All variants (default): adds all SKUs to the Product Selection, and automatically includes future SKUs added to the Product.
    - Only the following variants: adds selected SKUs to the Product Selection, and prevents future SKUs added to the Product from being included automatically.
    - All variants with SKU values except: adds all Product Variants to the Product Selection except the selected SKUs, and automatically includes future SKUs added to the Product.
  - If the selected Product Selection is of type Exclusion:
    - All variants (default): excludes all SKUs to the Product Selection, and automatically excludes future SKUs added to the Product.
    - Only the following variants: excludes selected SKUs to the Product Selection, and prevents future SKUs added to the Product from being excluded automatically.
  A Product can be assigned to a Product Selection only once. If the selected Product is already assigned to the selected Product Selection, the Product variant(s) column displays the previous assortment during bulk-assignment to check and update the assortment accordingly.
  If the Product Selection is active in a Store, the associated storefront is automatically updated on saving the updated Product Selection.
Click Next.
In the Confirm bulk assignments dialog, click Assign products.
The process cannot be paused. To manage the assignment, see Manage Products in a Product Selection.

Assign a Product Selection to a Store

A Product Selection can be assigned to one or many existing Stores, and each Store can contain up to 100 Product Selections. For more information on how to configure a Store, see Stores.

A Store’s assortment is shaped by its assigned Product Selections and whether the Product Selections are active or inactive for the Store.

If Product Selections of type Inclusion are assigned to a Store and all of them are inactive, then the Store’s assortment will be empty. If at least one is active, then the Store’s assortment will include the respective Products only.
If Product Selections of type Exclusion are assigned to a Store and all of them are inactive, then the Store's assortment will include all Products. If active, then the Store's assortment will not include the respective Products.
If Product Selections of types Inclusion and Exclusion are assigned to a Store and active, then exclusion of Products takes precedence.

To assign the Product Selection to a Store, follow these steps:

Go to Settings > Project settings > Stores and select the Store.
In the Store settings section on the Store's page, select the Product Selection from the Product Selections drop-down.
To link the Product Selection to the Store, click the Status toggle for the respective Product Selection.
For the changes to take effect on the Store, you must save the changes. In the Activate Product Selection dialog, click Understood to confirm.
Click Save store and in the Update store dialog, click Confirm.
On saving, all Products in the Product Selection are immediately available on your storefront.
Updating a Store configuration may invalidate existing carts on your storefront.

Manage Products in a Product Selection

If an SKU assigned to a Product Selection is renamed, the change is automatically updated in the Product Selection. If the last remaining SKU of a Product Selection is removed, then the Product Selection assignment will be empty and you must manually assign Product Variants to it.

Go to Products > Product Selection list and select the Product Selection.
On the Assigned Products tab, click Edit list of assigned variants of this product for the Product to manage.
You will be redirected to the Product Selections tab of the respective Product. On this page, you can only edit the Product Selection that you selected in the previous step.
To manage the Product Variants, click the edit icon and select any of the following options depending on your current and future assortment management plans:
- If the selected Product Selection is of type Inclusion:
  - All variants (default): adds all SKUs to the Product Selection, and automatically includes future SKUs added to the Product.
  - Only the following variants: adds selected SKUs to the Product Selection, and prevents future SKUs added to the Product from being included automatically.
  - All variants with SKU values except: adds all Product Variants to the Product Selection except the selected SKUs, and automatically includes future SKUs added to the Product.
- If the selected Product Selection is of type Exclusion:
  - All variants (default): excludes all SKUs to the Product Selection, and automatically excludes future SKUs added to the Product.
  - Only the following variants: excludes selected SKUs to the Product Selection, and prevents future SKUs added to the Product from being excluded automatically.
To remove the Product from the Product selection, click the delete icon.
Click Save.

Delete a Product Selection

A Product Selection assigned to a Store cannot be deleted.

Go to Products > Product Selection list, select the Product Selection and click Delete Product Selection.
In the Delete Product Selection dialog, click Delete Product Selection.