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.

   

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

   

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

   

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

   

   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.

   

   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.

   

8. Click Confirm. The content type is displayed.

   

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.

   

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

   

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

   

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

   

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

   

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

   

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

   

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