Product List - beta

The Product List helps you manage and search for products in your commercetools project. This feature is marked as beta and may be affected by changes.

Product List

The Product List displays all products for you to see and manage. 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.

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

Indexing a project

Warning: 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 product list now.

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

The Product List interface

The Product List interface has three sections:

product-list-interface

  • Product List: Displays products which match the current search and filters, and let 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 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 - beta.
  • Search Filters Opened when you click the Filters button, this list shows all filters available and in use.

Using the 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 product(s) to perform the bulk action on in the product list. select-products-1

    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 do the following:
    • Publish: publishes the selected products.
    • Unpublish: unpublish the selected products.
    • Delete: delete the seelcted products.
    • Bulk update: update the selected product’s product attributes 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.

Customizing the 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 column manager button.
  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 display a certain amount of product attributes. You can use the search functionality to load more.

The basic search field is a keyword search which searches over specific fields in a product’s data. You can search for the following product data using basic search:

  • Product name
  • Product description
  • Product SKU
  • Product variant key

To search for products, enter a valid search term into search field and press enter. Currently, you can only search for one search term at a time.

We recommend that new users use basic search, but if you need more powerful product searching, take a look at Advanced Product Search - beta.

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 filters into sidebar drop-down.

using-filters

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 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 filters into the sidebar 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.

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

my-views-product-search

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.

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