---
title: Add links
slug: cms-13/docs/add-links
docTags: 
createdAt: 2026-07-30T20:22:07.530Z
---

Links connect readers to related content across your website and external sources. The following link types are available by default in Optimizely Content Management System (CMS 13):

- **Page** – Links from one page to another on the same website.
- **Media** – Links to images, documents, and other media files stored on the web server.
- **Email** – Creates an email message with the linked email address.
- **External** – Links to content on other websites or media on file shares.
- **Anchor** – Links to sections within a page, letting readers jump between topics on a page. Also known as bookmarks in other applications.

**Shortcuts** are a specific type of link used for navigation and reusing existing website information.

## Create a link

Create a link through drag and drop (pages and media files), or by selecting text and clicking **Insert/edit link** in the rich-text editor toolbar. When you drag and drop a page or media file into a valid element, Visual Builder creates the link automatically. Edit the link the same way you insert a link in the rich-text editor by clicking **Insert/edit link**.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/-pKEIYkNQzITEZXyYWPe3_66061f5fdf97f818b453089960044a381702f731a4c3a430c7c170808900b436-image.png)

The **Create Link** window displays.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/k_btHsNRuztjrwmQGpdzn_11d139c0e6700a34754819341006a2fb82e635f8ca59ed66c8ec561dffb3ab79-image.png)

- **Link title** – Displays as descriptive text for the link on hover.
- **Open in** – Displays the link in a new window, often for links to external sources.
- **Language** – Links to a specific language version for content. **Automatic** directs visitors to the detected browsing language version.

Select one of the following link types:

- **Page** – Create a link to a page on the same website. See [Link to page on the same website](docId\:ZZdBLmc8eKL4nCUkejDGm).
- **Media** – Create a link to a media file on the same website. See [Link to media files on your site](docId\:ZZdBLmc8eKL4nCUkejDGm).
- **Email** – Create a link to an email address. See [Create a link to an email address](docId\:ZZdBLmc8eKL4nCUkejDGm).
- **External link** – Create a link to a page on an external website. See [Link to files on a file server or page on an external website](docId\:ZZdBLmc8eKL4nCUkejDGm).
- **Anchor** – Create a link to a specific location on a page. See [Create anchor links](docId\:ZZdBLmc8eKL4nCUkejDGm).

### Link to page on the same website

Create internal links in two ways:

- Place the cursor in the rich-text editor where you want the link, and drag the desired page from the page tree into the location. The page name becomes the link name (which you can edit if needed).

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/p4vS2WvWjmvXvfK1JrHtd_70b4327eb120c9bfdd0fff70bf94ba4e7489e01e348c2382a86249d55caaf947-image.png)

- Select the text where you want the link in the rich-text editor, and click **Insert/edit link**. In the **Create link** window, complete the **Link title**, **Open in**, and **Language** fields, and then select the **Page** option and select the page to link to.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/tblkEAH1dl9DcfPzopWPH_189bb57c373c044d3ef990d5d9c57596f35814155639367822f092767c32e9e7-image.png)

**Remaining URL**

Use the **Remaining URL** field to add or edit query string parameters. A query string is a dynamic part of a link and is not related to the website structure. It can be data from a logged-in user, data from a form submission, search result data, and so on. For example:

- **Site URL with query string** – `https://www.alloyexamplesite.com/Search/?searchQuery=reseller`
- **Query string** – `?searchQuery=reseller`

In this example, the query string parameters following the URL open the search results for "reseller".

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/2GM5FBC0MyiyBz5UGk7MH_1a2f469f7139a227dd7c1f7704e54c67cf50e88ed14e1cb3124ec94f04b76d16-image.png)

### Link to media files on your site

Create links to media in two ways:

- Place the cursor in the rich-text editor where you want the link, and drag the desired media file (PDF, Word, and so on) from the **Media** tab of the assets pane into the location. The filename becomes the link name (which you can edit if needed).

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/oDfjCMpyUztuqfj4WhC1g_236686c8bbf6daa0ac09e7ce12d8e64cb39869bd4fbcc25f88f63ce51d8870ee-image.png)

- Select the text where you want the link in the rich-text editor, and click **Insert/edit link**. In the **Create link** window, complete the **Link title**, **Open in**, and **Language** fields, and then select the **Media** option and select the media to link to.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/s1izcV9FRjRE8LhG4KHt3_4293a72f4b817791ae3969658a5f67d94642bf28cf2102a0bc7271b0a3301c3f-image.png)

:::hint{type="info"}
**Note**
Create a link to any type of document. The behavior when a visitor clicks the link depends on the file format and the settings of the visitor's computer.
:::

### Link to an email address

1. Select the text where you want the link in the rich-text editor.
2. Click **Insert/edit link**.
3. Complete the **Link title**, **Open in**, and **Language** fields.
4. Select the **Email** option and enter the email address to link to.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/1v_DWnmiuLlp6oU1OyDv0_b1245d8c497df089c62d22d535e4d20d83793fbf65ac85c2e1d57cbcd2664f86-image.png)

5. Click **OK**. When a user clicks the link, their default email client opens with the email address entered in the email address field.

### Link to files on a file server or page on an external website

1. Select the text where you want the link in the rich-text editor.
2. Click **Insert/edit link**.
3. Complete the **Link title**, **Open in**, and **Language** fields.
4. Select the **External link** option and enter the external link to link to.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/GhLMyojj3J4pZzOWvZzzr_46cf2a950b43ceb075463e8dd5f9c3ecba91628992b7d28893cd9734716cb434-image.png)

5. Click **OK**.

For a file server, enter the complete path, including the computer name and the filename with the file extension. The file storage network location must be properly accessible for this to work. Valid external prefixes are *http*, *https*, *ftp,* and *file*.

If you create an external link to a page found on the website you are working on, Optimizely recognizes this and automatically converts it to an internal link. If the link contains query string parameters, you can edit the query string parameters in the remaining URL.

### Create anchor links

An anchor link is a link to a specific location on a page.

1. Insert an anchor from the rich-text toolbar in the location where you want to link to.  Do not use special characters or spaces in the anchor name.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/nuOzsZtESpVQ0EWU4Zhzz_7ca7861a0632385973e102bd78804cfd55c87f2c1c3e64e102ad56940e729f48-image.png)

2. Select the text where you want to link from in the rich-text editor.
3. Click **Insert/edit link**.
4. Complete the **Link title**, **Open in**, and **Language** fields.
5. Select the **Anchor** option and select the anchor you created.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/udVPcRgi9N4LuKmboCVhu_79237f40382054991db172c046fce257fb1190f0ce8ef048cd2a88a0a894fa0a-image.png)

6. Click **OK**.

## Link properties

The following examples show common implementations of link functionality on websites, with functionality similar to the link window described in the previous section.

### Image link

When you add images to content areas intended for images or blocks, use an image link property to select an image from a folder in your site's media. The image link property places the image in the content area automatically. See [Add and edit images](docId:-o0gg-XGmAGQTjS2zdPc8).

### Link collection

A link collection is a property where you can manage a group of links.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/unUACyu1Li64HHCuy0fVj_4e8435fbca79b5cd91360a9c3885f5f87d4dd68e0ce2ab2b9416e4a6d8774ed0-image.png)

On the **Content** tab of the [All Properties](docId\:zT-P1YWoHabPisrAA4Du4) view, create links and other content by dropping pages or media files in the **AdditionalData** area, or by creating links through the link window. Create links for pages, media files, external sources, and email addresses. Move links to change their display order. Edit the displayed name of the link as needed.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/KbYUrIfSbUsBe-SvnyXyJ_6abaa9ffa8e9f8f30774d7aa265ce9fe7c076389aead0f179b221612d949fb43-image.png)

## Link to Commerce Connect catalog entries

If Optimizely Commerce Connect is installed, the link window contains an option to select items from the product catalog when you create links. See [Manage content](docId\:YWuayuK1-etw4qLs0c2Pg) in the Optimizely Commerce Connect documentation.