Create and manage spaces
Spaces introduce an additional layer in Kontent.ai that helps you provide a channel-specific context for your content. No more juggling multiple websites in separate projects and thus creating unwanted silos. See how spaces add the missing piece to the headless puzzle.
Explore your path to mastery- Discover how to best set up your multi-channel project to cover all your use cases.
- Check out how you can use spaces in Web Spotlight to manage multiple websites.
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.To manage spaces, you need the Manage spaces role permission.- In
Environment settings, select Spaces. - Click Create new space.
- Type the new space name.
- Click Save.
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.- In Environment settings, select Spaces.
- Select a space to configure.
- Create or add an existing root item.
- Click Save.
Multiple previews with spaces
The most significant benefit spaces bring you is the ability to set up multiple previews within one project. This is especially useful if you use the same project for different brands or channels. Each of such divisions can be represented by one space. Additionally, you can use spaces with live preview or Web Spotlight for multiple websites.
Tip: See how spaces work in a real-world scenario in our multi-brand sample project.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:- In Environment settings, select Spaces.
- Click a space to open its card for editing.
- In the Collections dropdown menu, select collections to assign them to the space.
- Click Save.
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.
Collections may be shared across spaces or private to one space.
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.Filtering content by a space that's not linked to any collection yields no results. That's because content items are connected to spaces via collections.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.What happens with preview in collections without a space link?If you don’t link spaces to collections, content creators always see all the previews configured for the particular content type. Similarly, the preview options aren’t filtered for collections that aren’t linked to any space.