> For the complete documentation index, see [llms.txt](https://docs.scaleflex.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scaleflex.com/portals/building-a-portal/inline-editor/links.md).

# Links

Turn selected text into a link to a page, a section, or a web address.

## Add a link

1. Select the text you want to turn into a link. The control does nothing without a selection.
2. Select **Add link**, or press `Ctrl`/`Cmd` + `K`.
3. Under **What do you want to link to?**, choose a destination.
4. Choose how it opens.
5. Select **Save**.

<figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FMr9H3YaCdCyuP4rz2keN%2Fimage.png?alt=media&#x26;token=efa8c39c-bbd6-4cac-8a0c-e8ceaff52940" alt="" width="195"><figcaption><p><strong>Add link</strong> in the inline toolbar, with its shortcut.</p></figcaption></figure>

## What you can link to

| Option                | Goes to                                           |
| --------------------- | ------------------------------------------------- |
| **None**              | Nothing — removes an existing link.               |
| **Page**              | Another page in your Portal.                      |
| **Section or anchor** | A particular section, or an anchor within a page. |
| **URL**               | A web address.                                    |

<figure><img src="https://2536208400-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fqsq2dR7Fjagf5eTifWZx%2Fuploads%2FzOOHHno2CplAVdsbiexv%2Fimage.png?alt=media&#x26;token=9f2b6c7f-4632-4553-b342-7574f5c6066f" alt="" width="375"><figcaption><p>The link dialog, where you choose what the text points at.</p></figcaption></figure>

A **URL** must start with `https://`, `http://`, `mailto:` or `tel:`.

Linking to a **Page** or a **Section or anchor** rather than pasting a URL means the link keeps working if that page's address changes later.

## How it opens

| Option          | What happens                                                             |
| --------------- | ------------------------------------------------------------------------ |
| **New window**  | The link opens in a new browser tab, leaving your Portal open behind it. |
| **Current tab** | The link replaces your Portal in the same tab.                           |

For anything outside your Portal, **New window** is usually the kinder choice, so visitors don't lose their place.

## Links and Connect to DAM

A piece of text can be a link **or** connected to the DAM, not both. Turning on one offers to turn the other off, and warns you before it does.

{% hint style="info" %}
Links take their color from your Portal's design rather than from the Color control.
{% endhint %}