Salesforce Commerce, a renowned e-commerce platform, empowers businesses to establish and manage online stores with unparalleled efficiency and flexibility.

This app enables content editors to select products and categories from a connected Salesforce Commerce Cloud 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-salesforce.
2. In the field configuration, define the following values:
   • clientId (required): The clientId of the API client.
   • clientSecret (required): The clientSecret of the API client.
   • shortCode (required): The eight-character string associated with a realm. Learn more in the Salesforce documentation.
   • siteId (required): The siteId is the name of the site (sometimes called a “channel”) for which you want to access data. Learn more in the Salesforce documentation.
   • 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.

Create an API Client in Salesforce

Follow the steps in the Salesforce documentation to create an API Client. Please note the following:

1. Please save the password you picked in a secure place. Later, it will be used as the plugin's clientSecret.
2. When selecting the roles, select the “Salesforce Commerce API category.” For the role scope, make sure to select the instance you want to integrate with. Do not select the “All Sandboxes” option.
3. For the allowed scopes, define sfcc.catalogs and sfcc.products. Do not add other scopes.
4. Select client_secret_post as the Token Endpoint Auth Method.

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