---
title: Working with links and anchors
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

You can make certain sections of the text clickable by creating hyperlinks. Once clicked, these links navigate users to different pages or, as described in [working with anchors](#working-with-anchors), to different sections of a page.

## Working with links

You can create the following types of links in the editor:

- [Attachments links](#placing-attachments-links) – allow you to create links to the attachments of the page that you are currently editing.
- [Content links](#placing-content-links) – allow you to create links to files stored in the content tree of any of the sites running in the system.
- [Media libraries links](#placing-media-libraries-links) – allow you to create links to content stored in [media libraries](https://docs.kentico.com/k11/managing-website-content/working-with-files/media-library-files.md).
- [Web links](#placing-web-links) – allow you to create links to different websites.
- [E-mail links](#placing-e-mail-links) – allow you to create email links that create a new email in the user's default email client and automatically fill in the fields that you specify.
- [Anchors links](#working-with-anchors) – anchors allow you to navigate users to different sections of the same page.

### Placing attachments links

1. With your mouse, click in the text where you want to create a link or mark the text that you want to make into a link.
2. In the editor toolbar, click on the **Insert/Edit** **link** button. An **Insert link dialog** opens.

   ![Inserting link](https://docs.kentico.com/docsassets/k11/working-with-links-and-anchors/placing_links.png "Inserting link")
3. Switch to the **Attachments** tab.
4. (Optional) If the attachment that you want to create a link to isn't attached to the page, use the **Upload** button to attach it.
5. ** Select** the attachment that you want to create a link to.

   ![Selecting a target for an attachment link](https://docs.kentico.com/docsassets/k11/working-with-links-and-anchors/selecting_attachment.png "Selecting a target for an attachment link")
6. (Optional) If you haven't marked any text that you want to make into a link, fill in the **Link text** field on the **General** tab.
7. On the **Target** tab, specify how the link opens once users click it:
   1. **(not set)** – default setting, opens the link in the same browser window or tab as the page.
   2. **(frame)** – opens the link in the frame specified in the **Target frame name** field.
   3. **New window (\_blank)** – opens the link in a new browser window.
   4. **Same window (\_self)** – opens the link in the same browser window or tab as the page.
   5. **Parent window (\_parent)** – opens the link in the browser window the current page is nested in.
   6. **Topmost window (\_top)** – opens the link in the browser window that is positioned on the top.
8. **(Optional) Specify Advanced properties.**

   - **ID** – the identifier of the link HTML element
   - **Name** – the name of the link HTML object
   - **Tooltip** – the text displayed when the mouse cursor is placed over the link
   - **Class** – the link element CSS class
   - **Style** – additional link element styles
9. Click **Save & Close**. The system creates the attachment link.
10. **Save** the page you are editing.

Now, the attachment opens when a user click the link on the page.

### Placing content links

1. With your mouse, click in the text where you want to create a link or mark the text that you want to make into a link.
2. In the editor toolbar, click on the **Insert/Edit** **link** button. An **Insert link dialog** opens.

   ![Inserting link](https://docs.kentico.com/docsassets/k11/working-with-links-and-anchors/placing_links.png "Inserting link")
3. Switch to the **Content** tab.
4. In the **Site** drop-down list, specify the site on which the content that you want to link to is.
5. In the **Content tree**, navigate to where you want the link to lead to.
6.  **Select** the specific page that you want to create a link to.
7. (Optional) If you haven't marked any text that you want to make into a link, fill in the **Link text** field on the **General** tab.

   ![Selecting a target for a content link](https://docs.kentico.com/docsassets/k11/working-with-links-and-anchors/selecting_content_file.png "Selecting a target for a content link")
8. On the **Target** tab, specify how the link opens once users click it:
   1. **(not set)** – default setting, opens the link in the same browser window or tab as the page.
   2. **(frame)** – opens the link in the frame specified in the **Target frame name** field.
   3. **New window (\_blank)** – opens the link in a new browser window.
   4. **Same window (\_self)** – opens the link in the same browser window or tab as the page.
   5. **Parent window (\_parent)** – opens the link in the browser window the current page is nested in.
   6. **Topmost window (\_top)** – opens the link in the browser window that is positioned on the top.
9. **(Optional) Specify Advanced properties.**

   - **ID** – the identifier of the link HTML element
   - **Name** – the name of the link HTML object
   - **Tooltip** – the text displayed when the mouse cursor is placed over the link
   - **Class** – the link element CSS class
   - **Style** – additional link element styles
10. Click **Save & Close**. The system creates the attachment link.
11. **Save** the page you are editing.

Now, when a user clicks on the link, they are navigated to the page that you specified.

### Placing media libraries links

1. With your mouse, click in the text where you want to create a link or mark the text that you want to make into a link.
2. In the editor toolbar, click on the **Insert/Edit** **link** button. An **Insert link dialog** opens.

   ![Inserting link](https://docs.kentico.com/docsassets/k11/working-with-links-and-anchors/placing_links.png "Inserting link")
3. Switch to the **Media libraries** tab.
4. In the **Site**, **Group** and **Library** drop-down lists, specify the media library in which is the content you want to link to.
5. (Optional) Use the **Upload** button to add the file you want to link to into the media library.
6.  **Select** the media library item that you want to create a link to.

   ![Selecting a target for a media library link](https://docs.kentico.com/docsassets/k11/working-with-links-and-anchors/selecting_media_file.png "Selecting a target for a media library link")
7. (Optional) If you haven't marked any text that you want to make into a link, fill in the **Link text** field on the **General** tab.
8. On the **Target** tab, specify how the link opens once users click it:
   1. **(not set)** – default setting, opens the link in the same browser window or tab as the page.
   2. **(frame)** – opens the link in the frame specified in the **Target frame name** field.
   3. **New window (\_blank)** – opens the link in a new browser window.
   4. **Same window (\_self)** – opens the link in the same browser window or tab as the page.
   5. **Parent window (\_parent)** – opens the link in the browser window the current page is nested in.
   6. **Topmost window (\_top)** – opens the link in the browser window that is positioned on the top.
9. **(Optional) Specify Advanced properties.**

   - **ID** – the identifier of the link HTML element
   - **Name** – the name of the link HTML object
   - **Tooltip** – the text displayed when the mouse cursor is placed over the link
   - **Class** – the link element CSS class
   - **Style** – additional link element styles
10. Click **Save & Close**. The system creates the attachment link.
11. **Save** the text you are editing.

Now, the media library opens when a user click the link on the page.

### Placing web links

1. With your mouse, click in the text where you want to create a link or mark the text that you want to make into a link.
2. In the editor toolbar, click on the **Insert/Edit** **link** button. An **Insert link dialog** opens.

   ![Inserting link](https://docs.kentico.com/docsassets/k11/working-with-links-and-anchors/placing_links.png "Inserting link")
3. Switch to the **Web** tab.
4. In the **Protocol** drop-down list, select the protocol on which the website you link to runs.
5. (Optional) If you haven't marked any text that you want to make into a link, fill in the **Link text** field.

   ![Specifying a web link](https://docs.kentico.com/docsassets/k11/working-with-links-and-anchors/creating_web_link.png "Specifying a web link")
6. On the **Target** tab, specify how the link opens once users click it:
   1. **(not set)** – default setting, opens the link in the same browser window or tab as the page.
   2. **(frame)** – opens the link in the frame specified in the **Target frame name** field.
   3. **New window (\_blank)** – opens the link in a new browser window.
   4. **Same window (\_self)** – opens the link in the same browser window or tab as the page.
   5. **Parent window (\_parent)** – opens the link in the browser window the current page is nested in.
   6. **Topmost window (\_top)** – opens the link in the browser window that is positioned on the top.
7. **(Optional) Specify Advanced properties.**

   - **ID** – the identifier of the link HTML element
   - **Name** – the name of the link HTML object
   - **Tooltip** – the text displayed when the mouse cursor is placed over the link
   - **Class** – the link element CSS class
   - **Style** – additional link element styles
8. Click **Save & Close**. The system creates the web link.
9. **Save** the text you are editing.

Now, when a user clicks on the web link on the page, the browser opens the new address as you specified.

### Placing e-mail links

1. With your mouse, click in the text where you want to create the link or mark the text that you want to make into an e-mail link.
2. In the editor toolbar, click on the **Insert/Edit link** button. An **Insert** **link dialog** opens.

   ![Inserting link](https://docs.kentico.com/docsassets/k11/working-with-links-and-anchors/placing_links.png "Inserting link")
3. Switch to the **E-mail** tab.
4. (Optional) If you haven't marked any text that you want to make into a link, fill in the **Link text** field.
5. Fill in the fields that you want the user to have prefilled when they click the e-mail link.
6. Click on **Save & Close**. The system creates the e-mail link.
7. **Save** the text you are editing.

Now, when a user clicks on the e-mail link on the page, their default e-mail client creates a new message and prefills the fields that you specified.

## Working with anchors

Anchor hyperlinks allow you to create links to certain parts of a text. You can then use these links to navigate users to different sections of a page, for example, to different headers. Once a user clicks a link pointing to an anchor, the page scrolls to where you placed the anchor. You can place anchors anywhere in a text area.

### Placing anchors

You can insert an anchor anywhere in a text area.

1. With your mouse, click where you want to place the anchor.
2. In the editor toolbar, click on the **Anchor** button. An anchor properties dialog appears.

   ![Inserting an anchor](https://docs.kentico.com/docsassets/k11/working-with-links-and-anchors/placing_anchor_links.png "Inserting an anchor")
3. Fill in the **Anchor Name**.
4. Click on **OK**. The system places the anchor in the text.
5. **Save** the text you are editing.

You can now link to the anchor as described below. 

### Linking to anchors

1. Mark the text that you want to use as a link to the anchor [that you created](#placing-anchors).

   ![Marking the text to link to an anchor](https://docs.kentico.com/docsassets/k11/working-with-links-and-anchors/image.png "Marking the text to link to an anchor")
2. In the editor toolbar, click on the **Insert/Edit** **link** button. An Insert **link dialog** opens.

   ![Inserting link](https://docs.kentico.com/docsassets/k11/working-with-links-and-anchors/placing_links.png "Inserting link")
3. Switch to the **Anchor** tab.
4. In the **Link to existing anchor with name**, choose the anchor that you created previously.\
   If you are creating a link to an anchor that doesn't yet exist, you can type it's name in the **Link to the following anchor** field.

   ![Linking to an anchor](https://docs.kentico.com/docsassets/k11/working-with-links-and-anchors/selecting_anchors.png "Linking to an anchor")
5. Click **Save & Close**. The system creates the link to the anchor that you specified on the page.
6. **Save** the text you are editing.

Now, when a user clicks on the link on the page, the page scrolls to the anchor.