Skip to content

StoryBlok Integration

Connecting your StoryBlok account to AltText.ai allows you to automatically generate alt text whenever you add images to the StoryBlok asset manager.

Setup

Configure your integration with StoryBlok by logging into to your AltText.ai account, then going to the Account: Integration Settings tab, and clicking on the section labeled "StoryBlok".

1. Add StoryBlok account info

Add the following required fields, which you can get from your StoryBlok account:

  • Region: The StoryBlok server region -- you can find this in your Space settings under "Server Location".
  • Access Token: A personal access token, which you can find/create in your StoryBlok Account Settings, in the Personal access token section. Make sure you set a long enough expiration time on your token! If it expires, you will need to update this token in your AltText.ai integration settings to a valid token.
  • Webhook Secret: [optional] If you are on a StoryBlok paid account, you can add a secret key for extra security when creating your webhook in StoryBlok. If you do this, you will need to copy the secret key here so the webhook can be verified.

2. Add a StoryBlok webhook notification

The last step is to create a webhook notification in your StoryBlok space that will fire each time an image is added to your asset manager. This will trigger AltText.ai to generate alt text for the new image, and update it in StoryBlok.

  • Copy the Endpoint URL shown on your integration settings page.
  • Login to your StoryBlok account, then go to Space you want to connect, and go to the space Settings: Webhooks section.
  • Click +New Webhook, and then paste the copied URL into the Endpoint URL field.

  • For the Triggers, select Asset created and Asset replaced.

    Setting up a StoryBlok webhook for your AltText.ai integration

That's all you need to do! Now whenever you add a new image asset to your StoryBlok space, alt text will automatically be generated by AltText.ai, and the "alt" field of image in StoryBlok will be updated with that alt text.

Importing Existing Images

To process your existing StoryBlok images, you can use our bulk import tool in the image library. Go to Images, click the Import tab, then select Storyblok.

Starting an Import

  1. Select the StoryBlok space you want to import from.
  2. Optionally check Skip images that already have alt text to avoid reprocessing.
  3. Choose your alt text language and any generation options.
  4. Click Generate Alt Text.

The import runs in the background — you can close the page and come back. Progress updates in real time via the import dashboard.

AltText.ai Storyblok bulk import configuration showing space selection, skip existing option, language selection, and generation options

Tracking Progress

Go to Images > Import > Bulk Imports > Storyblok to see all active and recently completed imports. Each import shows:

  • Total images discovered
  • Generated, skipped, and failed counts
  • Real-time progress percentage
  • Error details for any failed images

Import History

Completed imports are persisted so you can review past runs, including the number of images processed and any errors encountered.

Note

Private assets are not currently supported for bulk import. Only publicly accessible images will be processed.