- Concepts
Spaces
Learn what spaces are and how you can use them to organize content.
Spaces organize website content in the Page Builder. Teams can use spaces to group content from specific page types or custom types, allowing content writers to quickly navigate to the content they need.
By default, all content appears in a space called Main Space.
A Prismic repository with multiple spaces.
For large teams that need precise publication control, custom user roles let you manage who can edit and publish content across spaces.
Video overview
Create a space
Open your repository
Navigate to your Prismic repository to manage your spaces.
You must be the repository owner or have admin rights to manage a repository’s spaces.
Create a space
In the Spaces section of your repository’s left sidebar, click Create a space.
The create a space button in the Page Builder.
The space name determines the label shown to content writers in the Page Builder. Use an easily understood name.
The manage your space section allows you to assign page types and custom types to the space. For example, you could select the Blog Post and Author types for a space named “Blog.”
(Optional) Set custom user roles
Determine who can edit and publish content within the space using custom user roles. Learn more about custom user roles below.
Custom user roles
Custom user roles allow for restricting who can edit and publish content within a space and locale.
Configuring a space with custom user roles.
The following roles are available:
- Read-only: Read access. Cannot edit or publish content.
- Writer: Read and write access. Cannot publish content.
- Publisher: Read and write access. Can publish content.
How to assign custom user roles
Open custom user role settings
In your Prismic repository, open the settings for the space you want to update.
Select the User role tab in the modal.
Assign user roles
Search for a user in the left panel to assign permissions or select Everyone in the repository to update the default permissions.
Assign a role for each locale.
Media library
The media library is currently shared across the entire repository without specific roles or permissions.
All spaces can see and use any media uploaded to the media library.
Locales
Locales are enabled for the entire repository, including every space.
All spaces can manage content for any enabled locale.
Releases
There are some restrictions to keep in mind when working with releases.
Note that releases are not connected to a space. A release made in one space will appear in all spaces.
Publishing a release across spaces
To publish a release, a content writer must have Publisher permissions in all spaces included in the release.
For example, a “Black Friday” release could include pages in the Marketing and Blog spaces. A user must have Publisher permissions in both the Marketing and Blog spaces to publish the release.
Adding pages to a release
Any content writer with at least Writer permissions can add pages to a release. Documents from any space can be added to the release.
Frequently asked questions
Can users see which page types and custom types are in which spaces?
Yes. A space’s settings shows which page types and custom types are assigned.
A space’s settings showing its assigned content types.
How does page search work across spaces?
Searching in the Page Builder returns documents in all spaces. Space-specific filtering may be added in the future.
What happens to documents if a space is deleted?
Documents will revert to the main space.