---
title: Multi-Space Orchestration
description: Discover Storyblok's documentation with comprehensive developer guides, user manuals, API references, and examples to help you get the most out of the headless CMS platform.
url: https://www.storyblok.com/docs/manuals/multi-space-orchestration
---

# Multi-Space Orchestration

Multi-space orchestration lets you synchronize content across multiple spaces in your [organization](/docs/manuals/organizations).

The main feature, content distribution, is a way to duplicate a story across connected [spaces](/docs/manuals/spaces), and keep those duplicates up-to-date with overwrite and merge actions.

> [!NOTE]
> Multi-space orchestration is only available on specific plans. Learn more on the [pricing page](https://www.storyblok.com/pricing).

## Setup

First, open **Organization** → **Settings** → **Content Distribution** and select connected spaces. Distribution is only supported in spaces within the same region.

Next, add a source space. Depending on your setup, this space can be the single source of truth or serve as both a source and a target:

-   A single source of truth: the source space can only push stories to one or more target spaces, but never receives content from them.
-   A source and a target: the source space has a dual function—it can push stories in one configuration while receiving stories from _other_ source spaces in a second configuration.

[![Storyblok's content distribution settings screen, where users can configure source and target spaces](https://a.storyblok.com/f/212319/2880x1697/f42261dbac/content-distribution-settings.png/m/720x0/)](https://a.storyblok.com/f/212319/2880x1697/f42261dbac/content-distribution-settings.png)

A source space configured to distribute content to two target spaces

A source space configured to distribute content to two target spaces

Connected spaces must use the same block structures and definitions. To share these components across multiple spaces, install the [Shared Components app](https://www.storyblok.com/apps/sharedspace), or use the [@storyblok/schema package](https://www.storyblok.com/docs/libraries/js/schema).

## Manage distributed stories

In the source space, open a story in the [Visual Editor](/docs/manuals/visual-editor), and select the **Distribute** section in the left toolbar. The list includes all versions of the story that exist in target spaces, and their publication status.

[![The Distribute section open Storyblok's Visual Editor](https://a.storyblok.com/f/212319/2879x1698/75eeb1a5d3/content-distribution.png/m/720x0/)](https://a.storyblok.com/f/212319/2879x1698/75eeb1a5d3/content-distribution.png)

The Distribute section in the Visual Editor

To duplicate, overwrite, or merge stories, you must have [permission](/roles#permissions) to create and edit content in both the source and target spaces.

### Clone

To duplicate a story in a target space, select **Clone**. Storyblok creates the new story in the target space, also creating the same relative folder path if one doesn’t already exist. The source and cloned stories are automatically associated with one another.

To edit a duplicate story, select it from the list and open it in a new browser tab. Make independent content changes in the target space.

### Merge

To replace the target story’s structure with that of the source story, open the source story, and select **Merge**. The merge action updates only [blocks fields](https://www.storyblok.com/docs/concepts/fields#blocks), preserving the target story’s existing content.

### Overwrite

To replace the target story’s structure and entire content with that of the source story, select **Overwrite**.

> [!TIP]
> The content distribution feature is similar to Storyblok’s [Dimensions app](https://www.storyblok.com/apps/locales), designed for managing alternative versions of stories across spaces.

## Troubleshoot

-   **Existing stories:** the **Clone** action fails if a story with the same slug already exists in the target space. In the target space, delete or move the existing story before attempting to clone.
-   **Shared assets:** the **Clone** action doesn’t apply to assets; it preserves references to the original asset in the source space. When using [shared asset libraries](/assets#shared-asset-libraries), ensure that the target space has access to the same shared asset library as the source space.
-   **Internal links:** the **Overwrite** action only updates internal links and references if you cloned the relevant stories beforehand. To prevent broken links, manually review and update internal links and references in the target space’s version.

## Further resources

[Changelog: Multi-Space Content Distribution](https://www.storyblok.com/cl/2026-august-multi-space-content-distribution)

  

## Pagination

-   [Previous: Labs](/docs/manuals/labs)
-   [Next: Organizations](/docs/manuals/organizations)