---
title: Link property
slug: cms-saas/docs/link-property
docTags: 
createdAt: 2026-07-30T20:18:10.000Z
---

This topic describes the attributes of the **Link** property, which stores types of link-related items. The following image shows **Link** property type examples.

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

## Configure Link property

- **Name** – Enter the name of this **Link** property type. This is used when programming and making language settings.
- **Type** – Lets you change the content type to any other.
- **Link type** – Select how to manage links to resources, navigation elements, downloadable content, and other linked assets within an application's content structure.
  - **Link Collection** – A grouping of link items. You can set the minimum and maximum number of link items. It looks similar to this when rendered in the [All Properties editing view](docId\:PNu5GCyhm3OF7lElAjY1Q).

    ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/QXyKjOuvHZxnT_H33QXOn-20260722-181223.png)

:::Paragraph{indent="2"}
When you select **Add Link** > **Create a new link**, the **Create Link** page displays.
:::

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/SgIbFBDWwFF4pdMMUS-Nd-20260722-181223.png" size="100" isUploading="false" showCaption="false" indent="3"}

:::Paragraph{listStyleType="disc" indent="2"}
**LinkItem** – Stores a URL, the text to display, and a target property to specify whether the link should be opened in the same window or a new one. It looks similar to this when rendered in the [All Properties editing view](docId\:PNu5GCyhm3OF7lElAjY1Q).
:::

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/T_zzBkR5mHZfzg_ijF026_linkitemsaas.png)

:::Paragraph{listStyleType="disc" indent="2"}
**URL to Document** – A link that points to a document resource. The document could be a PDF, Word file, Excel file, and so on. It looks similar to this when rendered in the [All Properties editing view](docId\:PNu5GCyhm3OF7lElAjY1Q).
:::

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Cv9QrY8us9bt5ZHcsKfWt_link-with-url-to-document.png)

:::Paragraph{indent="2"}
When you click **Select Media**, the Content Manager picker opens and lists the media you can select. If your instance is connected to Optimizely DAM, the picker also lists DAM assets.
:::

:::Paragraph{listStyleType="disc" indent="2"}
**URL to image** – A link that points to an image resource. It looks similar to the following when rendered in the [All Properties editing view](docId\:PNu5GCyhm3OF7lElAjY1Q).
:::

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/QRFfz4Q_Z04rTL3HMdwgd_link-with-url-to-image.png)

:::Paragraph{listStyleType="disc" indent="2"}
**URL to page/external address** – A link to a page in CMS (SaaS) or a link to an external web address. The system might maintain the link for internal pages even if the page's location changes within CMS (SaaS)'s structure. For external applications, it is a traditional hyperlink to a web address. It looks similar to this when rendered in the [All Properties editing view](docId\:PNu5GCyhm3OF7lElAjY1Q).
:::

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/fSijxzKWGUj5B-1n7wiwt_link-with-page-or-external-address.png)

- **Value must be entered** – Select to require the user to enter a value in a **Link** field. Required fields display a red asterisk (\*).
- **Unique value per language** – See [Define language-specific properties](docId:9OqXINr7GMDWzBtaHETSI).
- **List** – Unavailable.
- **Property Indexing Type** – Unavailable.
- **Default value** – Select the options to define the **Link** field's value.
  - **No default value** – The field is empty (no pre-populated content).
  - **Inherits value** – The field value is derived from another source. This is often used in hierarchical systems where child elements can inherit values from their parent elements. For example, a sub-page in a CMS might inherit some property values from its parent page.
  - **Custom** – Enter a value to display in the field. The following image shows `www.optimizely.com` displayed as the default value.

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

- **Display in edit view** – Unavailable.
- **Display name** – Enter the text you want to display above the **Link** element on the page in the **All Properties** view.
- **Help text** – If you want help text to display next to the **Display Name**, enter the text. The following image shows how the help text displays.

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

- **Sort index** – Specify a value to determine the order in which data is displayed or processed.
- **Property Group** – Select a property group (**Categories**, **Content**, **Dynamic Blocks**, **Preview**, **Scheduling**, **SEO Settings**, **Shortcut**) to organize your content on tabs in the [All Properties editing view](docId\:PNu5GCyhm3OF7lElAjY1Q) of the content type.

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