AI Assistance

Storyblok's AI features assist with content creation and management needs, including translations, alt text, and SEO. Admins can enable AI features at either the space level or the organization level by going to Settings > AI Settings.

AI Translations

AI Translations generates professional-level translations of content in multiple languages.

Caution

AI Translations is part of Storyblok Labs and is thus still in the beta stage. Enable it as shown in Labs.

Note

The AI Translations feature does not currently work with folder-level translation or the Dimensions app.

AI Translations currently supports the following languages:

• English
• Spanish
• French
• German
• Italian
• Dutch
• Portuguese
• Russian
• Japanese
• Korean
• Chinese
• Polish
• Romanian
• Swedish
• Finnish
• Norwegian
• Czech
• Bulgarian
• Hungarian
• Danish
• Slovenian
• Turkish

  Tip

  Hint: Use the AI Languages API endpoint to get the list of supported languages.

Setup

At least one additional language needs to be configured under Settings > Internationalization.

AI Translations will only generate translations for fields that have been marked as translatable with the Translate toggle.

Translating a story

To translate a whole story, open the Languages menu in the Visual Editor, hover over the target language, and click the AI Translate icon (a magic wand).

Using AI Translations to translate a story

A modal will ask to confirm changes to any fields that have already been translated.

After generating translations, an Discard AI translation updates button will appear next to the Languages menu.

Caution

Note: AI Translate will handle all text-based content fields. AI Translate will not handle asset metadata (e.g. captions or copyright). You may need to translate these fields manually.

Translating individual fields

To translate a single field, select the target language from the Languages menu in the Visual Editor. Click the translate icon (a magic wand) on the field to translate.

Using AI Translations to translate a field

A modal will preview the translation. To regenerate the translation, click Generate New Translation. To apply the translation, click Add Translated Content.

AI Alt Text

AI Alt Text generates accessibility text for images in the Storyblok asset manager. To generate alt text, click Generate Alt Text in the asset uploader.

AI Alt Text Generation in Asset Upload Modal

AI Ideation

The Ideation Room feature in Storyblok enables drafting and improving potential articles. You can use AI features in the Ideation Room to create new content and enhance existing content. Read more about using AI for ideation in the Ideation Room editor guide.

AI SEO

The AI SEO app helps you generate SEO tags for your application using AI. Read more about the application in the editor guide.

AI Customization

AI Customization allows you to customize your API integration by using your own credentials, choosing your preferred model, and adding fine-grained configurations. Admins can apply customizations at the space or organization level.

The following AI providers and corresponding models are available for use:

AI Provider	Supported Models
OpenAI	gpt-3.5-turbo, gpt-4, gpt-4-turbo, gpt-4o
Google Gemini	gemini-2.5-pro-preview, gemini-2.5-flash, gemini-2.0-flash, gemini-1.5-pro

Spaces

In your space settings, go to AI Settings and select your AI Setup.

To apply organization-level settings to the space, toggle the inherit option.

To apply space-level settings, choose an AI setup from the AI setup dropdown or create a new setup.

AI Settings Configuration Page

In the panel, select your AI provider and model, and enter your API credentials.

AI Provider and Model Selection Panel

Adjust AI behavior by adjusting generation settings like temperature, top-p, and stop sequences to control how the AI responds. Click Run Validation to test the connection, then click Save.

AI Configuration Validation Testing

Organizations

To create a custom AI provider at the organization level, go to Settings > AI Settings.

Choose an existing AI setup from the AI Setup dropdown or click Create Custom AI setup to create a new one.

Organization-Level AI Customization Settings

In the panel, fill in the relevant info and click Save to make it available across all organization spaces.

AI Branding

AI Branding provides style customizations for AI output.

Context

To supply context, open the Branding tab in AI Settings. The context allows you to define your industry, product, audience, and voice.

AI Branding Configuration for Spaces

Output rules

AI Output Rules are the basic building blocks for configuring AI Branding at a granular level. These rules are defined in natural language and provide specific instructions for how the AI should generate or format content.

Some examples of AI output rules:

• "Avoid pronouns in the first sentence of a paragraph."
• "Always write the brand name 'Storyblok' in camel case, italic, and bold."

To create a new rule in a space, go to AI Settings > AI Permissions and Custom Setup > AI Output Rules and click Add new rule.

AI Output Rules Management

Add the name and instructions for your rule. Optionally, select style groups to add this rule to.

Creating a New AI Output Rule

Style groups

An AI style group is a collection of AI output rules. A style group can contain multiple output rules, and an output rule can be a part of multiple style groups. An AI style group is what ultimately affects the output of the AI when you choose to apply it on the organization or the space level.

An example of an AI style group could be "Internal HR compliance," and it might contain multiple output rules, such as:

• Do not use emojis.
• Use gender neutral language.

To create a new group, go to

To create a new rule in a space, go to AI Settings > AI Permissions and Custom Setup > AI Style Groups and click Add new style group and select output rules for the group.

Create AI Style Group in a Space

Organization defaults

Admins can govern AI Branding at the organization level from the organization settings. Organizations can define default style groups, restrict the creation of style groups at the space level, and determine behavior when style groups exist at both the space- and organization-level.

Set up Default Style Groups for the Organization

AI Credits

Usage of Storyblok's AI features consumes AI credits. The number of initial AI credits available per space depends on your pricing plan. See the pricing page for further reference.

AI credits are different from AI tokens. Tokens in the context of LLM are units of text in queries, while AI credits in Storyblok are a multiple of the token cost per query. Each AI action consumes a certain number of credits based on the underlying token cost and model used. Read more about tokens in this OpenAI FAQ.

Provider	Model	AI Credit per Token Cost
OpenAI	gpt-3.5-turbo	2.00
	gpt-3.5	2.00
	gpt-4o	2.00
	gpt-4-turbo	3.00
	gpt-4	4.00
Gemini	1.5 Flash	2.00
	1.5 Pro	2.00
	2.5 Pro	2.00
	2.5 Flash	2.00

Usage

The Organization dashboard has an overview of the monthly AI credits available and a space-wide breakdown of AI credits usage.

AI Credits Usage on the Organization Dashboard

History

In Organization > Settings > AI Settings, use the View Usage History button to see a breakdown of your AI credits consumption history. You can choose a time period and filter by provider, feature, user, and space.

Tip

Usage history can also be viewed at the space level under AI Settings within a Space.

AI Usage History on the Organization Dashboard