About Cross-space references


Cross-space references is a feature by Contentful that allows you to link content across spaces and environments. Using references, you can create reusable content and update multiple spaces and environments with the same piece of content.

NOTE: To use the Cross-space references feature, you must have at least two spaces within your organization.

Access the feature

Important: To access the Cross-space references feature, you must first enable orchestration for the spaces you want to link content across. For more information on how to enable spaces for orchestration in the web app, see About content orchestration.

To access the Cross-space references feature:

  1. Log in to the Contentful web app.

  2. Navigate to the "Home" tab.

    manage content models

  3. Click Manage references. The "Content model" tab is displayed.

You can use Cross-space references in the web app, or using the Content Management API.


  • 3 reference fields per content type

  • 20 distinct spaces/environments per reference field 

  • 50 linked entries per field, over all locales

  • At least one content type per source/space

  • Cross-space references are resolved using the Content Delivery API and the GraphQL API

Was this helpful?
add-circle arrow-right remove style-two-pin-marker subtract-circle remove