Cross-space references in Rich Text fields: hyperlink to entries

You can use Cross-space references in Rich text fields to link to entries from different spaces in your organization. The linked (referenced) entry is embedded from another space as a hyperlink in the rich text, which allows you to reuse content and ensure consistency. 

Important

You can only reference entries from spaces that are enabled for orchestration. For more information, see Enable spaces for orchestration

You can only reference entries that are allowed to be referenced.

How to allow an entry to reference other hyperlinked entries

  1. Log in to the Contentful web app.

  2. Navigate to the “Content model” tab, and select the content type you want to allow to link to other entries in your rich text.

    Cross-space Select content type

  3. On the rich text field you want to allow to reference other entries, click Edit. The field editor is displayed.

    X-space Field editor

  4. In the “Settings” section, under “Allow hyperlinks”, select the Link to entry (different space) option.

    Cross-space references in Rich Text Link to entry (different space)

    NOTE: To limit access only to specific content types, a validation error occurs.

  5. In the “Validation” section, under "Link to entry (different space)”, select the space from where you want to reference the content type(s).

    Cross-space references in Rich Text Select space for hyperlink

    NOTE: When selecting the space, the environment is automatically preselected.

  6. If you want to pick a different environment, select it from the drop-down menu.

    Cross-space references in Rich Text Select env hyperlink

    NOTE: The "Select environment" drop-down menu is active only if you have at least two environments available. Otherwise, it becomes inactive and defaults to the one environment available (master).

  7. Select the content type(s) you want to reference.

    Cross-space references in Rich Text Select content type hyperlink

  8. Click Confirm. The content type is displayed.

    Cross-space references in Rich Text Click Confirm

  9. Click Save to apply your changes.

How to reference entries from another space

To reference entries from another space in your Rich text field:

  1. Log in to the Contentful web app.

  2. Navigate to the “Content” tab and select the entry where you want to include the reference. The entry editor is displayed.

    Cross-space references in Rich text Inline entry editor

  3. Write the text you want to create the hyperlink to, and highlight/select it.

    Cross-space references Select text to hyperlink

  4. Click on the hyperlink button. The "Insert hyperlink" window is displayed.

    Cross-space references in Rich Text Click hyperlink

  5. In the "Link type" field, select Entry (different space).

    Cross-space references in Rich Text Insert hyperlink window

  6. Under "Link target", click the Select entry. The "Add existing entry" window is displayed.

    X-space references in Rich Text Select entry

  7. Select the space and environment from which you want to link entries, and the entry you want to include.

    Cross-space references in Rich Text Add existing entry hyperlink

  8. Click Insert to link the text to that entry.

    Cross-space references in Rich Text Click Insert


    Your entry is added as a hyperlink to the selected text.

    Cross-space references in Rich Text Final result