Products

The Product list displays all Products that exist in your Project and lets you do the following:

• add and remove Products within your Project
• view and edit Product details
• publish and unpublish Products to manage their visibility in your stores
• export your current Product list to make it transferrable between Organizations and Projects and import it back
• search through your Products using the powerful search and filters in the view

Create a Product

1. Go to Products > Add product.
2. Select a Product type from the list of Product types created in your Project.
3. Click Next.

4. Enter the details for the Product.

   • For Product name, enter localized names for the Product.
   • For Product description, enter localized descriptions for the Product.
   • For Product key, enter a unique identifier value for the Product.
   • For Product categories, select the Categories for the Product. If the Recommended categories setting is enabled for your Project, Categories will be generated upon creating the Product.
   • For Product price mode, select the type of Price to be used for the Product at checkout.
   • For Tax category, select the Tax Category for the Product.
5. Enter custom Product attributes configured for your Project. Fill in at least one locale configured for your Organization.
6. Click Next.
7. Click Add variant to add Product Variants for the Product.
   • Optional: For SKU, enter a SKU value for the Product Variant.
   • Optional: For Variant key, enter a unique identifier value for the Product Variant.
   • Enter the details for the Attributes.
   • Click Save.
8. Click Next.

9. Enter localized keywords for your internal storefront search.

10. Add external search information for search engine optimization (SEO).

    • For URL slug, enter localized slugs for the Product to be used by external search engines.
    • Optional: For Meta title, enter localized meta titles for the Product to be used by external search engines. To use the same names for the Product, as defined earlier, click Use localized product name.
    • Optional: For Meta description, enter localized descriptions for the Product to be used by external search engines. To use the same descriptions for the Product, as defined earlier, click Use localized product description.
11. As a rule, first Product Variant created is automatically set to the master Product Variant. Click the Set to master button on the desired Product Variant page to promote a Product Variant to master.
12. Click Save.

You can now add images, Prices, Inventory, and store-based tailored data for the Product.

Add images

1. Go to Products > Product list.
2. Select a Product and click the Variants tab.
3. Select a Product Variant and click the Images tab.
4. Click the Add image button and upload an image of your Product Variant.
5. Close the Product Variant window to finish modifications.

Merchant Center supports only .jpg, .png and .gif image formats. Maximal file size is 10 MB per image. Image filenames should not contain spaces.

Add Prices

1. Select a Product Variant and click the Prices tab.
2. Click Add embedded price and enter the price information.
   • Optional: For Price key, enter a unique identifier value for the Embedded Price.
   • For Price, select the currency and enter the money value.
   • Optional: You can add additional constraints for your Embedded Price.
   • Optional: To make the Embedded Price available only to Customers in a specific location, select a country from the Country drop-down.
   • Optional: To make the Embedded Price available only to a specific group of Customers, select a Customer Group from the Customer group drop-down.
   • Optional: To make the Embedded Price available only for Products sold through a specific Channel, select a Channel from the Channel drop-down.
   • Optional: To make the Embedded Price available for a specific time period, select the dates and time for Price valid from and Price valid to.
3. If present, select a Custom Field for the Price and enter a value for it.
4. Click Save.
5. Close the Product Variant window to finish modifications.

Add Inventory

1. Select a Product Variant and click the Inventory tab.
2. Click Add inventory and enter the Inventory details.
   • Optional: For Channel, select a Channel; each Channel can be assigned to an Inventory only once.
   • For Quantity, enter the total stock units available for the Product Variant.
   • Optional: For Average restock period (days), enter the number of days it takes to restock the Product Variant.
   • Optional: For Expected delivery, enter the expected date and time of restock of the Product Variant.
3. If present, select a Custom Field for the Inventory and enter a value for it.
4. Click Save.
5. Close the Product Variant window to finish modifications.

Add tailored data for a Product

You can tailor your product information to adapt to different brands or regions—based on your business requirements—to increase your visibility, customers' loyalty, and orders.

To add tailored data for a Product, do the following:

1. Go to Products > Product list and select a Product.
2. On the Product details page, select a Store from the drop-down.
3. Enter the tailored values for Product name, Product description, Key for tailored data, and any Product Attributes.
   If no value is given for a field, when publishing the tailored data, the related Product Projection falls back to the default Product data for the respective fields.
4. Click Save tailored values in store.
5. Optional: To tailor meta information for the Product, click the Int. / Ext. Search tab, enter the tailored values for URL slug, Meta title, and Meta description.
6. Click Save.

To add tailored data for a Product Variant, do the following:

1. Go to Products > Product list and select a Product.
2. Click the Variants tab and select a Product Variant.
3. Select a Store from the drop-down.
4. Optional: To tailor Attributes, enter the tailored values for the Attributes and click Save tailored values in store.
5. Optional: To tailor images, click the Images tab and click Add image by URL. Upload an image and click Save tailored values in store.

After saving your tailored Product Projection, you can manage the visibility of tailored values.

Publish tailored data

1. Go to Products > Product list and select a Product.
2. To publish the tailored data, select store-based values. If fallback values is selected, the default (original) Product data is available for the Product (Variant) on your storefront.

Manage Products

You can perform the same action on multiple Products simultaneously or export a selection of Products from the Product list. For example, this can be useful in conjunction with the search feature to publish all the Products in a specific campaign or sale.

• Publish: publishes the selected Products.
• Unpublish: unpublishes the selected Products.
• Delete: deletes the selected Products.
• Bulk edit attributes: updates the selected Product's Attributes in bulk.
• Bulk edit categories: updates the selected Product's Categories in bulk.
• Bulk assign products to product selections: assigns Products to Product Selections in bulk.

Reorder Attributes

To reorder Product-level Attributes, do the following:

1. Go to Products > Product list.
2. Select a Product from the Product details page.
3. In the Product Attributes section, click Reorder and drag the Attribute fields accordingly. You can reorder fields only if no filter is applied for the Attribute fields.
4. Click Save.
5. In the Update your attribute order dialog, select if you want to save the field order only for the selected Product or for all Products of the respective Product Type, and then click Confirm.

Review modified Products

You can edit, revert, or publish your changes.

• To revert or publish all changes on the page, click Revert all or Publish all and confirm the action.
• To revert or publish all changes to a Product, click Revert or Publish. If one or more fields are edited or reverted, save your changes before reverting or publishing the changes.
• To revert individual changes, click Revert to published.

Manage Products in Categories

After this, proceed to editing Products in Categories:

1. Go to Products > Product list.
2. Select the Products and, in the Actions drop-down menu, select Bulk edit categories.
3. Select Categories to add or remove and click Next.
4. On the confirmation dialog, confirm the action.

Search for Products

To search Products, you must index your Product list in your Project. The indexing time can vary based on the size of the Product list.

Basic Product search

Advanced Product search

An advanced search query consists of the following top-level objects:

• query describes the data to be searched for and filters to be applied to results.
• filter (optional) defines the way to filter data found via query.
• sort (optional) describes the sorting of search results.
• pagination (optional) describes the pagination of search results.

In the examples below, you can see complete simple queries.

Find products with a specific price:

{
  "query": {
    "and": [
      {
        "exact": {
          "field": "variants.prices.currencyCode",
          "value": "EUR"
        }
      },
      {
        "exact": {
          "field": "variants.prices.centAmount",
          "value": 2222
        }
      }
    ]
  }
}

{
  "query": {
    "fullText": {
      "field": "variants.attributes.shirtColor",
      "value": "Green",
      "attributeType": "set_text"
    }
  }
}

Import and export

Import Products

To import Products into the Merchant Center, do the following:

1. Go to Products > Product list.
2. Click the Actions drop-down and select Import products.
3. In the Import products by CSV window, choose a CSV file on your computer to upload, and click Upload and preview.
   • Select the Publish all products in the file checkbox to update the current and staged representation of existing Products, and publish new Products. If not selected, the imported data will only update the staged representation of existing Products and new Products created by the import process are not published.
4. After the file is uploaded and validated, verify the rows and columns to be imported, and click Continue.
5. Click Start import to confirm the import process. As the import process is a background task, you do not need to wait for it to complete. To check the import status, go to Operations > Import.

Import Inventory

1. Go to Products > Product list.
2. Click the Actions drop-down and select Import inventories.
3. In the Import inventories by CSV window, choose a CSV file on your computer to upload, and click Upload and preview.
4. After the file is uploaded and validated, verify the rows and columns to be imported, and click Continue.
5. Click Start import to confirm the import process. As the import process is a background task, you do not need to wait for it to complete. To check the import status, go to Operations > Import.

Export Products or Inventory

Bulk unpublish via CSV import

1. Go to Products > Product list.
2. Click the Actions drop-down and select Bulk unpublish via CSV.
3. In the Bulk unpublish via CSV window, choose a CSV file on your computer to upload, and click Upload and preview.
4. After the file is uploaded and validated, verify the number of Products to be unpublished, and click Continue.
5. Click Start bulk unpublish to confirm the import process. As the import process is a background task, you do not need to wait for it to complete. To check the import status, go to Operations > Import.

Bulk delete via CSV import

1. Go to Products > Product list.
2. Click the Actions drop-down and select Bulk delete via CSV.
3. In the Bulk delete via CSV window, choose a CSV file on your computer to upload, and click Upload and preview.
4. After the file is uploaded and validated, verify the number of Products to be deleted, and click Continue.
5. Click Start bulk delete to confirm the import process. As the import process is a background task, you do not need to wait for it to complete. To check the import status, go to Operations > Import.