The Dimensions app provides a convenient way to create and manage alternative versions of stories grouped across folders designated for languages, regions, markets, and more.

Learn more about internationalization strategies available with Storyblok.

A common use case is working on a multilingual website. Using the Dimensions App, you can prepare a story in one language and quickly duplicate it in other languages using the Clone All or Create clone functionality. This ensures that each story is structured consistently, yet its content matches the relevant language.

Once duplicated, you can manage the story individually, adapting its structure or translating its content as required. Use the Merge functionality with granular field controls to synchronize the structure without overwriting the translated content.

How to use the app

Once installed, access the Dimensions tab from the Languages drop-down menu in the Visual Editor.

The Dimensions app supports the following actions:

• Clone All: Create a duplicate of the current story in all other top-level folders.
• Create Clone: Create a duplicate of the current story in the selected destination folder.
• Merge All: Copy over the structure of the current story to all corresponding stories in the other top-level folders.
• Merge: Copy over the structure of the current story to the corresponding story in the selected destination folder.
• Overwrite: Replace the structure and content of the corresponding story in the selected destination folder with that of the current story.

Granular field control

The Dimensions app provides granular control over merges and overwrites of each field. To manage these settings, select the relevant field in the Block Library and apply the preferred option under Edit field > Overwrite & Merge:

• Force overwrite by merge action. This option effectively transforms the Merge action into the Overwrite action. Select it when you want to duplicate the structure and the content (the field's value).
• Exclude from overwrite action. This option prevents the content (the field's value) from being overwritten. Select it when you want only to duplicate the structure and not the content.
• Exclude from merge action. This option prevents the structure (blocks) from being overwritten. Select it when you want a block to exist only in a specific story.

Blocks field special behavior

If you merge a story that includes the Blocks field, any nestable blocks inside it will be duplicated to the corresponding story in the selected destination folder.

To change the default behavior, set the Blocks field to Exclude from merge action. This will prevent all nestable blocks from being copied to the selected folder’s destination story.

Good to know

• The Clone actions are hidden if the story exists in one or more folders.
• When using Merge, the field's value (content) is only duplicated if provided when the block is first added to the story. Consequent merges will not affect the field value.
• The app automatically links corresponding stories across folders. Adapt the frontend code to notify search engines that the story has alternative localized versions. Check which stories are linked to the current one in the Config > Alternative version section of the Visual Editor.
• All the actions are bi-directional, no matter which story was the original and which was the clone.