Create and manage spaces

Why spaces are convenient

Spaces offer the convenience of:

• Providing specific channel previews of your content.
• Accessing and reusing content from collections connected to the particular space.
• Managing multiple websites under a project.
• Utilizing a single content model across various channels.

Create a space

Every environment can have several spaces. You can use different domains and preview URLs for each space.

1. In Environment settings, select Spaces.
2. Click Create new space.
3. Type the new space name.
4. Click Save.

Create as many spaces as you need.

Add a root item

The root item serves as the top-level unit of your navigation hierarchy. You can use any content item as a root item; however, it needs to include a subpages element.  To start building the navigation, you need to assign a root item to your space.

1. In Environment settings, select Spaces.
2. Select a space to configure.
3. Create or add an existing root item.
4. Click Save.

Multiple previews with spaces

If you’re working on a multi-regional or multi-brand project, you can use spaces to set up multiple previews for your websites. Once you’re done, go to Environment settings > Preview URLs > Space domains and type in the domain for each space, such as preview.example.org. Check out how to set up multiple previews in your project.

Connect spaces to collections

Assign collections to spaces to create a clear overview of what content belongs to which space. Collections can be space-specific (assigned to only one space) or shared across multiple spaces. To assign collections to spaces:

1. In Environment settings, select Spaces.
2. Click a space to open its card for editing.
3. In the Collections dropdown menu, select collections to assign them to the space.
4. Click Save.

Developers can connect spaces and collections using Management API.

Example connection between spaces and collections

Let’s say you have spaces for two product websites. For each product, you have a dedicated education department that creates customer success materials. On the other hand, you have one shared marketing department. Each department has its own collection:

• The collections for educational content aren’t shared across the spaces.
• The collection for marketing materials is shared across both spaces.

Filter content items by space

When you connect spaces to their related collections, it’s then possible to filter content items by space. This makes it easier for users in the project to find content because it helps them better see what content belongs to which space.

Preview options filtering

Another advantage of linking spaces to collections is that content creators only see the preview options relevant to the content item they’re about to preview.