Commercetools is a leading composable commerce platform that allows companies to tailor and scale shopping experiences across markets dynamically.

This app enables content editors to select products and categories from a connected Commercetools instance and reference them in Storyblok.

Setup

1. Once installed, navigate to the block library and create a new field of the type plugin (in either a new or an existing block). Set the custom type to sb-commercetools.
2. In the field configuration, define the following values:
   • endpoint (required): The API URL of the Commercetools instance (for example, https://api.us-central1.gcp.commercetools.com/). Learn more in the Commercetools documentation.
   • clientId (required): The client ID.
   • clientSecret (required): The client secret. For security, create the API client with only the view_products and view_categories scopes required by this app. If you reuse a client that was granted broader permissions, rotate it and create a minimally-scoped one, as the credentials are used directly in the browser.
   • locale (optional): The language key to display the name and description in a specific language (for example, en_US).
   • limit (optional): The maximum number of items that can be selected.
   • selectOnly (optional): If left empty, editors can choose products and categories. If set to product, only products can be selected. If set to category, only categories can be selected.
3. Use the block containing the field in the Visual Editor, select one or multiple products or categories, save the story, and check the API response.

Refer to the e-commerce concept for a detailed introduction to the topic.