Work with a sellable item

Current version: 9.3

Sellable items represent products in Sitecore Experience Commerce (XC). A sellable item refers to a tangible or non-tangible item or product that you manage in an online catalog. You manage catalog sellable items using the Commerce Merchandising tool.

Note

Typically, changes to sellable items become visible on the XC Storefront within a few minutes of publishing. Otherwise, you can manually trigger the update on the storefront.

Search for a sellable item

The Business Tools search 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 initiate 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 in 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 a product ID, a name, and a display name.

  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 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.

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.

Add a variant to a sellable item

You use variants to manage different variations of a parent sellable item.

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 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 the Add Sellable Item variant +.

  3. In the Add Sellable Item Variant dialog window, enter a value for each of the following properties: Variant ID, Name, and Display name.

    Add Sellable Item Variant dialog box

  4. To save, click the check mark.

Add an image to a catalog entity

You can add an image to catalog entities such as sellable items, product variants or bundles (static or dynamic). Product images are stored in Sitecore Media Library. Before you can add it to a catalog entity, you must make sure that the image exists in the Media Library.

Note

You cannot make changes to entity versions that are published. If required, add a version 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, and click Add an image +.

  3. In the Add Image dialog, in the Search Term field, start typing the name of the image until the search result displays the image you are looking for.

    Add image dialog box

  4. Select the required image, and then click the check mark to add it to the catalog entity.

Assign a price to a sellable item

The Sitecore XC Business Tools let you associate several different types of 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 to a sellable item. A price card allows you to 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 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.

    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 sellable item, whether it is published or not.

To update 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 this topic.

Associate a sellable item to a category

You can associate a sellable item to a category from a sellable item detailed page.

Note

If you need to disassociate a sellable item from a category, 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.

Do you have some feedback for us?

If you have suggestions for improving this article,