Use Prismic

Organize pages

Learn to find, search, and organize your Prismic content using the dashboard, spaces, and tags.

As your Prismic repository grows, you’ll need efficient ways to find and organize your content. This page covers Prismic’s built-in organization tools: the pages dashboard for browsing and searching, spaces for grouping content by project or team, and tags for flexible content labeling.

Find and browse content

Prismic’s pages dashboard is your central hub for accessing all content in your repository.

When you enter your repository, you land on the Work tab. The dashboard displays:

  • Page list: All pages in your repository, showing display name, page type, and status
  • Filter bar: Dropdown menus to filter by page type, language, status, or tags
  • Spaces: All spaces available in your repository, grouping pages by page type

A screenshot of the Work tab with access to all pages.

The Work tab with access to all pages.

Status indicators show each page’s current state:

  • Draft: Unpublished changes exist
  • Live: Published on your website
  • Archived: Hidden from main view but not deleted

Search for pages

Use Prismic’s search features to quickly locate specific content:

  • Text search: Enter keywords in the search bar to search page titles
  • Filter by page type: Click the Type dropdown to show only specific types (Blog Posts, Landing Pages, etc.)
  • Filter by tags: Choose tags to show only pages containing those tags
  • Filter by status: Use the status dropdown to show only drafts, published content, or archived items
  • Clear filters: Click the X next to any active filter to remove it

A screenshot of the search field with filters and results.

The search field with filters and results.

If you have multiple languages, select a specific language in the left sidebar before searching.

Page display name

Pages are identified in the Page Builder using a display name, such as in the main page list and when linking pages. A page’s default display name is based on the page’s text content, usually the first heading.

To set a custom display name to a page:

  • Navigate to the page in the Page Builder.
  • Click the display name in the top-left corner, next to the back button.
  • Customize the name.
  • Click outside the input to save the display name.

A screenshot of editing a page's display name in the Page Builder.

Editing a page’s display name in the Page Builder.

Spaces

To help content writers quickly find specific content, you can use spaces to group pages by one or more page type in the page list.

Spaces appear in the left sidebar when viewing your repository’s page list. You can add as many spaces as needed.

By default, all content appears in a space called Main Space.

A screenshot of a Prismic repository with multiple spaces.

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.

The media library is shared across the entire repository without specific roles or permissions. All spaces can see and use any media uploaded to the media library.

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.

    A screenshot of the create a space button in the Page Builder.

    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 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.

Per-space user permissions

Custom user roles allow for restricting who can edit and publish content within a space and locale.

  • 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.

    A screenshot of setting custom user roles in a space.

    Configuring a space with custom user roles.

  • 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. 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.

Page tags

Tags provide flexible labeling for your content, allowing you to categorize pages across different dimensions.

Tags are best used for internal organization, but they can also be used as a tagging system on your website. Work with your developer to set up a tagging system as necessary.

Add tags to pages

  • Open any page for editing
  • Find the Tags bar at the top of the middle panel
  • Type a tag name and press Enter
  • Add multiple tags by typing each one and pressing Enter
  • Save the page to apply the tags

Filter by tags

  • Go to your repository’s page list
  • Click on the search bar
  • Use the Tags dropdown in the filter bar to select one or more tags
  • Pages matching all selected tags will appear
Was this page helpful?