Shopware
Seamlessly integrate your Shopware e-commerce platform with Storyblok
![Shopware](http://a.storyblok.com/app-assets/1/70ceb4935b/cleanshot-2023-12-05-at-11-30-37-2x.png)
Shopware offers a holistic omnichannel digital commerce platform for sophisticated mid-market and lower enterprise merchants, with high flexibility and various options for B2C, D2C, B2B, as well as service-based use cases.
This app enables content editors to select products and categories from a connected Shopware instance and reference them in Storyblok.
Setup
In case your Shopware instance uses the Shopware API v3, please follow these steps:
- 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-shopware-64
. - In the field configuration, define the following values:
endpoint
(required): The API URL of the Shopware instance (e.g.,https://my-demo.store.shopware.store
).salesChannelKey
(required): The generated Shopware access key. Learn more in the Shopware 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 toproduct
, only products can be selected. If set tocategory
, only categories can be selected.
- 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.
Otherwise, please follow these steps:
- 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-shopware
. - In the field configuration, define the following values:
endpoint
(required): The API URL of the Shopware instance (e.g.,https://my-demo.store.shopware.store
).salesChannelKey
(required): The generated Shopware access key. Learn more in the Shopware documentation.accessKey
(required): The access key ID.secretAccessKey
(required): The secret access key.limit
(optional): The maximum number of items that can be selected.selectOnly
(optional): If left empty, editors can choose products and categories. If set toproduct
, only products can be selected. If set tocategory
, only categories can be selected.
- 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.
Please refer to the e-commerce concept for a detailed introduction to the topic.