Storyblok Connector: configuration and usage
Connect THRON to Storyblok and allow content editors to select assets directly from the headless CMS custom fields, without ever leaving the editor. Content is distributed via the THRON Content Delivery APIs and is automatically updated with every change on the platform.
Warning: the configuration of the Storyblok connector requires a technical deployment step. Contact technical support (support@thron.com)
Prerequisites
- Administrator access to your organization's Storyblok account
- Access to the THRON Admin Console to create the necessary apps — requires THRON team support
- Storyblok CLI installed in the development environment
- Storyblok Personal Access Token (can be generated from My account → Personal access token)
Step 1 — Create the folder and Custom Application on THRON
- In THRON, create a new folder that will contain all the assets to make available in Drupal (e.g.,
/channels/website). - Connect the folder to a THRON Custom Application (App SDK). If you haven't created it yet you can do so by following this guide.
- Once the app is generated, save the following values:
- Client ID
- App ID
- App Key
## In-depth articles
- Step 2 — Install the plugin in your Storyblok organization
- Request the THRON plugin package for Storyblok from THRON support — it includes a ZIP file with the source code and a README.md with complete instructions.
- Follow the README to start the project locally and verify the required variables.
- Set the mandatory environment variable:
-
STORYBLOK_PERSONAL_ACCESS_TOKEN— generate it from My account → Personal access token in Storyblok
-
- Deploy via the Storyblok CLI following the steps outlined in the README.
Step 3 — Configure the plugin in the Storyblok space
- Once the deployment is complete, log into your Storyblok space.
- The THRON plugin is now available as a custom field plugin to be associated with components (e.g., Image, Media, Video).
Go to Datasources, find the plugin and configure the field with the pKey, the Client ID and the Client Secret gathered in previous steps, the client and the username of your THRON account.
- Save the component configuration.
Recommended Configuration
| Parameter | Recommended value |
|---|---|
| Source folder | Folder dedicated to the web channel (e.g., /channels/website) |
| External app user | Dedicated user with access only to the source folder |
| Minimum role |
ROLE_CONTENT_EDITOR — add PRODUCT_USER only if necessary |
| Enabled content types | Image, Video, Audio, Document — enable only those in use to reduce search noise |
Final result
Once the configuration is complete, the THRON plugin appears as a native field within the Storyblok components. Content editors select assets directly from the THRON folder, with text search, filtering by locale, and filtering by content type. The selected asset returns a JSON object with the data necessary for the frontend to generate calls to the THRON Content Delivery APIs and distribute the content on the site.
Need help?
For questions on activation or for technical problems, write to support@thron.com.