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 transferable 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.
   Product Types created from your Smart Data Modeler proposal appear in this list after you import the proposal in Smart Data Modeler.
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 are 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 attributes configured for your Project. Fill in at least one locale configured for your Organization.
6. Click Next.
7. If displayed, click Add variant to add Product Variants for the Product. Otherwise, move to the next step.
   The Add variant button is displayed only for Projects that use the Classic product catalog model. For Projects that use the Modular product catalog model, you must add Variants through the Variants API.
   • 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. The first Variant created is automatically set as the Master Variant. Once you have created the Product, you can change the Master Variant.
   Treat the sku values as immutable identifiers. Finalize SKU naming before assigning Products to Product Selections to avoid background reconciliation and data migration work.
   When adding a new Product Variant, always enter a value for every Attribute with the Same for all constraint. Any Same for all attribute you leave empty defaults to an empty value on the new Variant, and the constraint then propagates that empty value across all other Product Variants.
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. 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 Add image and upload an image of your Product Variant.
5. Close the Product Variant pane to save your changes.

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

Add Prices

If the Product has the price mode set to Embedded, you can add Prices as follows:

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. To save your changes, click Save and then close the Product Variant pane.

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. To save your changes, click Save and then close the Product Variant pane.

Add tailored data for a Product

You can tailor your product information for different brands or regions based on your business requirements. This increases visibility, customer 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.
   All tailored fields are optional. Fields left empty fall back to the default Product data when published.

4. Click Save tailored values in store.
5. 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. To tailor Attributes, enter the tailored values for the Attributes and click Save tailored values in store.
5. 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 Product Attributes and Variant Attributes (that have the SameForAll constraint) of one or more selected Products in bulk.
• Bulk edit categories: updates the selected Products' Categories in bulk.
• Bulk assign products to product selections: assigns Products to Product Selections in bulk.

Reorder Attributes

To reorder 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 single 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.

Manage Variants

• Classic: Variants are embedded in their parent Product, which can have up to 100 Variants.
• Modular: Variants are standalone resources that you can model, publish, and unpublish independently from their parent Product. A Product can have up to 10 000 Variants. To learn more about the Modular product catalog model and how to adopt it, see Model and sell products with Modular Catalog and the Modular Catalog migration guide.

Add Variants

Set Master or default Variant

Publish and unpublish Variants

In a Project that uses the Classic product catalog model, you cannot publish or unpublish individual Variants. You can only publish or unpublish the Product, and consequently publish or unpublish the associated Variants.

Delete Variants

Manage Variant images

Filter and search Product fields

To filter fields by their completion state, select one of the following options:

• All fields: shows every field on the page.
• Empty: shows only fields without a value. For localized fields, all locales are empty.
• Filled: shows only fields with a value. For localized fields, at least one locale has a value.

To search for a field, enter a name, label, or value in the search box. The fields that the search matches depend on the page.

On the Product details page, the search matches the following fields:

• Attribute fields
• Product name
• Product description
• Product key
• Product categories
• Product price mode
• Tax category

On the Product Variant page, the search matches the following fields:

• Attribute fields
• SKU
• Variant key

When a Category value matches your search, only the matching Category tags remain visible. Reference Attribute values aren't included in the search.

Filled fields in the Product list

• Product name
• Product description
• Product key
• Product categories
• Product price mode
• Tax category
• SKU of the Master Variant
• Variant key of the Master Variant

Because the total depends on the Product Type, Products of different Product Types have different totals. The count includes both required and optional fields, and it covers the Product and its Master Variant only. Fields on other Product Variants aren't counted. A localized field counts as filled when at least one locale has a value. Product price mode always counts as filled because it can't be empty.

Filled fields for Product Variants

Search for Products

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

Basic Product search

In a Project that uses the Modular product catalog model, you can only search by Product name, description, slug, key, or Product Attribute. Querying by SKU or Variant key is not supported.

Advanced Product search

The advanced search mode gives you more control over your search by allowing you to compose a detailed query in a GraphQL-like query language.

In a Project that uses the Modular product catalog model, you can only query Product-level data (for example, Product name, description, and slug). Any query on Variant-related information, such as price, will return no results.

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.

{
  "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"
    }
  }
}

{
  "query": {
    "and": [
      {
        "fullText": {
          "field": "name",
          "language": "en",
          "value": "outdoor jacket",
          "mustMatch": "all"
        }
      },
      {
        "prefix": {
          "field": "slug",
          "language": "en",
          "value": "outdoor",
          "caseInsensitive": true
        }
      }
    ]
  }
}

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