---
title: "Work with a sellable item"
slug: "work-with-a-sellable-item"
abstract: "How to create and manage products as sellable items using the Commerce Business Tools."
---
# Work with a sellable item
Sellable items represent products in Sitecore Experience Commerce (XC). A sellable item refers to a tangible or nontangible item or product that you manage in an online catalog. You manage sellable items in the catalog using the Commerce Merchandising tool.
If a sellable item is part of a [product bundle](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-commerce/bundling.html "Bundling") (that is, it is a constituent sellable item), this relationship is indicated in the **Sellable Item to Bundle** section on the sellable item details page. This relationship is not displayed on the sellable item details page for variants. In the following example, the HD Glass Screen Protector is part of the Smartphone Bundle.
> [!note]
> Typically, changes to sellable items become visible on the storefront within a few minutes of [publishing](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-commerce/entity-versions-and-publishing.html "Entity versions and publishing"). Otherwise, you can [manually trigger the update on the storefront](https://doc.sitecore.com/xp/en/developers/103/sitecore-experience-commerce/manually-update-cache-and-indexing.html).
Search for a sellable item
The [Business Tools search](urn:resource:component:384349) feature allows you to search for sellable items from the Merchandising dashboard. The search looks across all existing catalogs and returns any sellable items that match or contain the search term you specified. A search is primarily based on a search term. However, you can also refine your search and reduce the number of results by specifying an additional keyword as a filter, in addition to your search term.
### About search terms and filters
When searching, you must provide a term to search on. You can use any of the following sellable item properties (indexed by default) as the term to search on:
- Name
- Display name
- Product ID
- Variant ID
- Variant display name
You can also search using a wildcard character (\*) as your search term.
> [!note]
> Indexed fields in your custom catalog ultimately determine the terms that you can search on.
You can use a *filter* in addition to a search term to further refine your search.
To search for sellable item:
1. On the Sitecore Launchpad, in the **Commerce** section, click **Business Tools,** and then click **Merchandising**. The Merchandising dashboard is displayed.
2. In the **Search** section, in the **Term** field, enter the sellable item term you want to search for.
3. Optionally, enter a filter to further refine your search.
> [!note]
> Filters use the same sellable item properties as sellable item terms.
4. Press **Enter** to start the search.
Create a sellable item
You can create a sellable item in a catalog, category, or subcategory. A sellable item must always be associated with one of these containers. If you disassociate a sellable item from a catalog, category, or subcategory, and it is not associated with any other, it still exists and can be found by using **Search** on the Merchandising dashboard.
To create a sellable item:
1. On the Sitecore Launchpad, in the **Commerce** section, click **Business Tools** and then click **Merchandising**.
2. On the Merchandising dashboard, in the **Catalogs** section, click the name of the catalog where you want to add the sellable item. To add a sellable item to a category or subcategory, in the **Categories** section click the relevant category name.
3. In the **Sellable Items** section, click the drop-down menu and click **Add Sellable Item**.
4. In the **Add Sellable Item** dialog box, enter the following mandatory information: a product ID, a name, and a display name.
> [!note]
> Optionally, you can specify additional details about the sellable.
5. To save, click the check mark.
The list of sellable items on a catalog or category details page is shown in the order that the sellable items were created.
Add a variant to a sellable item
You use variants to manage different variations of a parent sellable item. Each variant is an individual sellable item or product.
To add a sellable item variant:
1. In the Merchandising tool, navigate to the details page of the relevant sellable item.
> [!note]
> You cannot make changes to entity versions that are published. If required, [add a version](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-commerce/work-with-entity-versions.html "Work with entity versions") of the sellable item so that you can make the required changes.
2. In the **Variants** section, click the drop-down menu, and then click **Add Sellable Item variant** **+**.
3. In the `Add Sellable Item Variant` dialog box, enter a value for each of the following properties: **Variant ID**, **Name**, and **Display name**.
4. To save, click the check mark.
> [!important]
> Performance of the Content Editor might be impacted if you associate a high number of variants with each sellable item. This is because all sellable item variants are loaded even if you do not expand the sellable item when browsing the catalog in the Content Editor. To avoid this issue, minimize the number of variants associated with each sellable item.
Add an image to a catalog entity
You can add images to catalog entities such as sellable items, product variants, or product bundles (static or dynamic). Product images are stored in Sitecore [Media Library](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-platform/the-media-library.html). Before you can add an image to a catalog entity, you must make sure that the image exists in the Media Library.
The order in which an entity images are listed in the Business Tools reflects the order in which the storefront displays them. The first image in the list of images displays on the storefront as the main product image on the product details page, and also on the category page.
> [!note]
> You cannot make changes to entity versions that are published. If required, [add a version](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-commerce/work-with-entity-versions.html "Work with entity versions") so that you can make the required changes.
To add an image to a sellable item, a variant or a bundle:
1. In the Merchandising tool, navigate to the details page of the relevant sellable item, variant, or bundle.
2. In the **Images** section, click **Add an image** **+**.
3. In the **Add Image** dialog box, in the **Search Term** field, start typing the name of the image until the search result displays the image you are looking for.
4. Select the required image, and then click the check mark to add it to the catalog entity.
Change the order in which to display product images on the storefront
The order in which an entity's images are listed in the Business Tools reflects the order in which the storefront displays them.
The first image in the list of images displays on the storefront as the main product image on the product details page, and also on the category page.
To change the order in which product images are displayed on the storefront:
1. In the Merchandising tool, navigate to the details page of the relevant sellable item, variant, or bundle.
2. In the **Images** section, click the image you want to re-order.
3. On the **Images** section header, in drop-down list, click **Move Image Up**, or click **Move Image Up**.
> [!note]
> The image moves up or down one level at a time. To move the image another level, repeat [step 2](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-commerce/work-with-a-sellable-item.html#UUID-f6973312-4526-151e-8a27-c94b7e4cbe1f_N1622827244074 "Step 2") and [step 3](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-commerce/work-with-a-sellable-item.html#UUID-f6973312-4526-151e-8a27-c94b7e4cbe1f_N1622827307772 "Step 3") until the image appears in the order you want it to appear on the storefront.
Add item definitions to a sellable item
You add item definitions to a sellable item when you want that sellable item to inherit the custom child views of a [Composer template](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-commerce/work-with-custom-child-views.html "Work with custom child views").
To add item definitions to a sellable item:
1. In the Merchandising tool, navigate to the catalog, and then to the details page of the relevant sellable item.
2. In the **Details** section header, click the **Manages Item Definitions** icon.
3. In the **Manage Item Definitions** dialog box, under the **Item Definition** header, click the **Product** drop-down list to display all item definitions available in the catalog, and then select the required item definition checkbox.
> [!note]
> You can only assign one item definition per sellable item.
Assign a price to a sellable item
The Sitecore XC Business Tools let you associate several [different types of pricing](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-commerce/pricing.html "Pricing") with a sellable item, including a list price, multicurrency pricing, and tiered pricing.
### Assign a list price to a sellable item
To assign a list price to a sellable item:
1. In the **Sellable Items** section of a catalog, category, or subcategory details page, click the name of the relevant sellable item.
2. On the sellable item details page, in the **List Pricing** section, click **Add a list price** **+**.
3. In the **Add List Price** dialog box, enter list prices for each currency your store supports.
> [!note]
> The storefront displays the corresponding list price based on the currency that is configured in the storefront control panel settings, located at */sitecore/Commerce/Commerce Control Panel/Storefront Settings/Storefronts/\[storefront name\]/Currencies Display Adjustments*.
### Assign a card price to a sellable item
You can assign a [price card](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-commerce/pricing.html "Pricing") to a sellable item. A price card lets you assign price dynamically to a sellable item, based on a predetermined price change schedule.
To assign a card price to a sellable item:
1. In the **Sellable Items** section of catalog, category, or subcategory details page, click the name of the relevant sellable item.
2. In the **Pricing** section of the sellable items detail page, on the section header, click **Edit pricing** and, in the **Edit Pricing** dialog box, in the drop-down list, click the name of the price card to associate with the sellable item.
Delete a sellable item
You can permanently delete a sellable item from a catalog.
To delete a sellable item:
1. On the Sitecore Launchpad, in the **Commerce** section, click **Business Tools** and then click **Merchandising**.
2. On the Merchandising dashboard, click the name of the relevant catalog, category, or subcategory and, in the **Sellable Items** section, click to highlight the line of the sellable item you want to delete.
3. In the sellable item drop-down list, click **Delete** and, in the **Delete** dialog box, click **Delete**.
> [!note]
> By default, if you delete a sellable item that is part of product bundle, that bundle can no longer be purchased.
>
> You can [make the bundle available without the deleted item](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-commerce/work-with-a-product-bundle.html "Work with a product bundle").
> [!note]
> If you delete a sellable item that is associated with multiple catalogs, categories, or bundles, the Delete dialog box gives you the option to Disassociate sellable item. Select this option to undo associations to parent containers without deleting the item itself. You can then recreate new associations as required.
4. To save you changes, in the **Delete** dialog box, .click the check mark
Edit inventory set data associated to a sellable item
If a sellable item is already associated to an inventory set, you can change the inventory information directly on the sellable item details page.
> [!note]
> You do not need to create a new version of a sellable item in order to edit its associated inventory set information. You can edit the inventory details of any version of a sellable item, whether it is *[published](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-commerce/entity-versions-and-publishing.html "Entity versions and publishing")* or not.
To update an inventory set data:
1. In the **Sellable Items** section of a catalog, category, or subcategory details page, click the name of the relevant sellable item.
2. On the sellable item details page, in the **Inventory Sets** section, click **Edit the sellable item inventory set**.
3. In the **Edit Sellable Item Inventory** dialog box, make the necessary changes by editing the inventory data associated with a sellable item.
> [!note]
> For a list of editable fields, see [#UUID-44e5609c-c266-b91f-375d-f026b1232b62\_N1533326195933](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-commerce/work-with-inventory.html#UUID-44e5609c-c266-b91f-375d-f026b1232b62_N1533326195933 "Edit inventory information for a sellable item").
Associate a sellable item to a category from the sellable item detail page
You can associate a sellable item to a category from a sellable item detail page.
> [!note]
> If you need to [disassociate a sellable item from a category](urn:resource:component:390529), you must go to the category detailed page.
To associate a sellable item:
1. In the **Sellable Items** section of a catalog, category, or subcategory details page, click the name of the relevant sellable item.
2. On the sellable item details page, in the **Summary** section, click the drop-down menu, and then click **Associate category**.
3. In the **Associate category** dialog box, enter the category ID or the category name, and then click the check mark to save your changes.
> [!note]
> Sellable item relationships are not versioned. The exception to this is the bundle to constituent item relationships, which are versioned and can be different with each version.
Associate a sellable item to a category from the category detail page
You can associate a sellable item to a category directly from the category detail page.
> [!note]
> You can also associate a sellable item from the catalog detail page.
To associate a sellable item:
1. On the Merchandising dashboard, in the **Catalogs** section, click the catalog you want to add a sellable item to.
2. On the Catalog details page, in the **Categories** section, click the category you want to add the sellable item to.
3. On the Category details page, in the **Sellable Items** section, click the drop-down menu, and then click **Associate**.
4. In the **Associate** dialog box, click in the **Catalog** field and then click the catalog name to search the current catalog or click **All Catalogs** to search across all catalogs.
> [!note]
> Sellable item relationships are not versioned. The exception to this is the bundle to constituent item relationships, which are versioned and can be different with each version.