Centra is a composable e-commerce platform for brands that run global Direct-to-Consumer and Digital Wholesale operations. They allow you to serve all the markets with the right products, prices, and campaigns to scale up fast.

This app enables content editors to select products and categories from a connected Centra 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-centra.
2. In the field configuration, define the following values:
   • endpoint (required): The GraphQL API URL of the Centra instance (for example, https://sandbox.centra.com/graphql).
   • token (required): The generated Centra access token. Learn more in the Centra documentation. For security, create the token in Centra AMS with only the Product:read and Category:read scopes required by this app. If you reuse a token that was granted broader privileges, rotate it and issue a minimally-scoped one, as the token is sent from the browser on every request.
   • 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.