Product List

The Product List helps you manage and search for products in your commercetools project.

Product list

The Product List enables you to view and manage your products. You can search through your products using the powerful search and filter in the view. Catalog managers, merchandisers, localization managers, and anyone else who manages your product information will find the screen useful.

You might not see this section in the Merchant Center or edit data in it because of your User Permissions. User permissions are usually set by your company's IT staff.

Index a Project

Only a member of your organization's Administrators team can index a project. For more information, see The Administrators Team.

You need to index your project the first time you use the Product List. If you have a very large product catalog, indexing can take a few minutes.

To index your project:

  1. In the Merchant Center's main menu, navigate to Products > Product List.
  2. Click Index my product catalog now.

Once a project is indexed, the data is automatically kept up-to-date.

Product list interface

The Product List interface has three sections:


  • Product List: Displays products which match the current search and filters, and lets you access a product's product detail page. For more information, see Product List.
  • Product Search: Returns products which match the criteria in the search box. You can use the search toggle button to switch between basic search mode (magnifying glass) and advanced search mode. For more information, see Basic Search and Advanced Product Search.
  • Search Filters Opened when you click the Filters button, this list shows all filters available and in use.

Using Product list

The Product List displays all products that exist in your project. You can use it to do the following:

  • View and edit a specific product's product details.
  • Bulk publish and unpublish products, as well as export the current product list.
  • Customize the product list using the column manager.

View and edit a Product's details

View a product's product details (product variants, product attributes, prices, and more) by clicking on it in the Product List.

Bulk product actions

You can use the Product List to perform the same action on multiple products at the same time, or to export a selection of products. This is useful in conjunction with the search feature to publish all products which belong to a specific campaign or sale, for example.

To use bulk product actions:

  1. Check the products to perform the bulk action in the Product List. select-products

    Tip: Checking the checkbox in the Product List's header row selects all the products on the page. At the bottom of the Product List table, use the items per page dropdown list to set how many items display per page.

  2. In the Actions dropdown list, select the action you want to perform in bulk. You can perform the following actions:
  • Publish: publishes the selected products.
  • Unpublish: unpublish the selected products.
  • Delete: delete the selected products.
  • Bulk edit attributes: update the selected product's product attributes in bulk.
  • Bulk edit categories: update the selected product's product categories in bulk.
  • Export selected products: export the selected products using ImpEx.
  • Export current list: export all products which match the current search and filters using ImpEx. Only available if no products are selected in step 1.

Customize Product list columns

You can customize the data displayed in the columns of the Product List to better suit your own needs. To do this:

  1. Click the column manager button around the rop right of the page.
  2. Find and place the columns you want to display into the visible columns area. Remove the ones you don't.

By default, the hidden column section displays a certain amount of product attributes. You can use the search functionality to load more.

Search filters

You can filter through your products using the Filters panel. This is an extremely powerful way of using the Product List and managing your product catalog.

Using filters

To filter the search results, interact with the filter in the Filter sidebar by adding a filter. Each filter has its own interaction mechanism depending on the type of data it filters. You can add additional search filters using the Add sidebar filters drop-down.


When filtering search results, the order in which you interact with the filters matters. Selecting a filter reduces the available results for other filters.

Available filters

By default, all projects have the following filters:

  • Category: Filters using categories defined in your commercetools project. Use a category name, description, key, external ID, or URL slug.
  • Last modified at: Filters using the date or date range in which a product was last modified. Use a starting date/time, an ending date/time, or a time span between a starting date/time and an ending date/time.
  • Product type: Filters using one or more product type.
  • Status: Filters using one or more product publishing state.
  • State: Filters using one or more product workflow state. If no workflow is defined, all products are without a state.
  • Created at: Filters using the date or date range in which a product was created. Use a starting date/time, an ending date/time, or between a starting date/time and an ending date/time.

Optionally, use the Add sidebar filters drop-down search list to add the following filters.

  • Product Attributes: Filters using product attributes defined for your project's product types. Find each attribute by its label. Product attribute filters use different fields, based on the type of attribute and amount of data to display.

Save the column selection and search criteria as a view

Save your customised layout (the visible columns in the Product List and the filter sidebar) and/or your searches and applied filters in My views located in the top right corner of the page. When no customised views are saved, a default view is applied.


To save a view, open the drop-down next to My views and click save as new view. New views will be stored in that same drop-down. To load any of your customised views open the same drop-down and click in the desired view to load.

A customised view will display an orange dot when any change is applied to the layout, the search or filters. You can add those changes into the view or revert them as well as rename or delete that view inside the same drop-down menu.

Customised views are saved for your user account in the given project and are not shared with other projects or users.