Linking in your Turtl Doc

Find out how to link content in your Turtl Doc

Radovan Vidović avatar
Written by Radovan Vidović
Updated over a week ago

Linking to Doc Pages

You can link from your Immerse content to other pages within your Doc by following a few simple steps:

1. Highlight a word in your text that you want to create a link for. Click on the link button located on your editing toolbar.

2. Under the General tab select Page as the link type from the drop-down.

3. Select the chapter that you want to link to.

4. Now use the drop-down to select whether you want to link to the Surf, Immerse, or a bookmark (within the Immerse level) of that chapter.

Your link is now in place!

Linking for mobile view

In order for these links to work when your readers access your content on mobile, you need to make sure that the Immerse page you want to link to has a large, medium, or small heading (H1, H2, or H3). For more information on formatting text please follow this guide.

Once you’ve formatted your heading, you can link to the page by following the steps above and selecting the Immerse page, as shown below:

Note: Your heading should now appear next to an Immerse page, as shown in the first two options in the example above. If you don’t see a heading listed next to an Immerse page, as in the third option in the above example, there is no H1, H2, or H3 heading set, and the link will not work correctly on mobile.

Linking to other websites

You can insert a Turtl Doc URL into your Doc, allowing it to be opened alongside any other linked websites. Highlight the text you wish to link to another Turtl Doc and then click on the link icon. This will open a link dialogue box where you can add the URL of the Doc you want to link to and choose to open it in a lightbox or a new tab.


We suggest you either select 'New tab' or make sure that the linked page can be opened in a lightbox. Due to security reasons, some pages have the X-Frame-Options HTTP header set to sameorigin and therefore refuse to be embedded in an iframe on a different domain. Find out more about X-Frame options here.

When looking at the Doc as a viewer and the link is clicked on, the lightbox will open as seen below. 

Find out more about creating bookmarks here.

Linking to Email

Highlight the text that you wish to link to an email address, then select the link icon on the editing panel. On the dialogue box that appears click on E-mail and fill in the sender's information and template.

If you would like to change the linked text into a button, you can choose this from the Styles tab if this is available in your theme.

Did this answer your question?