> For the complete documentation index, see [llms.txt](https://helpdocs.conducttr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpdocs.conducttr.com/feature-documentation/designing-and-running/master-events-list/links.md).

# Links

Links can be used in different ways in Conducttr to **direct players to specific content**.

<table><thead><tr><th width="499.5999755859375">Benefit</th><th>Feature</th></tr></thead><tbody><tr><td>Share exercise content directly, and let players verify a link's legitimacy before clicking it</td><td>News article links</td></tr><tr><td>Direct players to a different channel at the right narrative moment</td><td>Hyperlinks</td></tr><tr><td>Send players straight to a specific post and add a rich preview to messages, replicating real messaging app behaviour</td><td>Permanent links</td></tr></tbody></table>

## Running

### News article links

In article-based websites, you can **share articles within the exercise**.&#x20;

All website links work across all channels. Whether you copy a link from the website, paste it into the address bar, or when you click to share article, both the URL and generated short link will be persistent.

<table><thead><tr><th width="108.4000244140625">Link type</th><th>Description</th><th data-hidden>Link</th><th data-hidden></th></tr></thead><tbody><tr><td>Copy</td><td>Copy link generates an <strong>internal link that can be pasted anywhere in your exercise</strong> and it will link to the referenced article (it will not work outside the Virtual Desktop)</td><td></td><td></td></tr><tr><td>External</td><td>External link generates a <strong>link that can be used outside the Virtual Desktop.</strong> The purpose of this is for when players need to create external reports (e.g. an intelligence summary INTSUM or situation report SITREP) in Powerpoint, say, or someother platform external to Conducttr. Clicking the external link will open open the browser and find the Conducttr content inside the exercise.</td><td></td><td></td></tr></tbody></table>

Click the `Share` icon at the top right corner of any article to share on available channels for your exercise.

<figure><img src="https://helpdocs.conducttr.com/~gitbook/image?url=https%3A%2F%2F3476309720-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsNKxYbIPgfYmCR9EJgAu%252Fuploads%252FQ7FD9fuD2SVyXfJPTUUl%252Fimage.png%3Falt%3Dmedia%26token%3D50dac7e5-bca3-4074-bb24-040b4eaead53&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=bb1e82ff&#x26;sv=2" alt=""><figcaption></figcaption></figure>

#### Hover over URL <a href="#hover-over-url" id="hover-over-url"></a>

Participants can **investigate potential phishing emails** (verifying the legitimacy of a link) by hovering over it to reveal the actual URL:

<figure><img src="https://helpdocs.conducttr.com/~gitbook/image?url=https%3A%2F%2F3476309720-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsNKxYbIPgfYmCR9EJgAu%252Fuploads%252FYx9JgU1qW3qxdJE5v4Lp%252Fimage.png%3Falt%3Dmedia%26token%3D4483bdf2-365e-41aa-a8d0-467e7edf2f4a&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=7aded87&#x26;sv=2" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If you're interested in other ways to use links during a live exercise, visit the page below:
{% endhint %}

{% content-ref url="/pages/5iyecjSUzz5AJmT9891i" %}
[Dynamic Retweeting with Smartwords](/feature-documentation/designing-and-running/pattern-of-life-pol/dynamic-retweeting-with-smartwords.md)
{% endcontent-ref %}

***

## Designing

### Hyperlinks

Use hyperlinks to **take players to a different channel** during the exercise. You can insert hyperlinks for any kind of content, but the most popular uses include directing players to the **Portal channel when new files have been uploaded** and to a **specific website in the Website/News channel**.

{% content-ref url="/pages/eX1N92cDLoqKAOms2koW" %}
[Portal](/feature-documentation/designing-and-running/channels/information-based-channels/portal.md)
{% endcontent-ref %}

{% content-ref url="/pages/oEEuutgDXM5n8iym0mYN" %}
[Website/News](/feature-documentation/designing-and-running/channels/popular-channels/website-news.md)
{% endcontent-ref %}

{% stepper %}
{% step %}

#### Highlight inject text and click the link icon

<figure><img src="/files/hzuyRo51jGpMlfinBnUO" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### In the small window that opens, click the link icon again

:arrow\_up:As seen in the screenshot above.
{% endstep %}

{% step %}

#### Select the channel you want the player to be directed to

For news articles, you can **select a specific website** you want the player to be directed to. The latest article will be the first shown on the website page, so this is what players will see when they follow the hyperlink.

<figure><img src="/files/ZCTTXrycfrO3lSWrOHjm" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Players can use the hyperlink to navigate between different channels

<figure><img src="/files/7pUEv9H9Vf8cWMvsde0Y" alt=""><figcaption><p>Hyperlinks in the Virtual Desktop</p></figcaption></figure>
{% endstep %}
{% endstepper %}

### Permanent links

This link will take players directly to a **specific piece of content**. This is different to the hyperlink option because you can direct players to social media posts, as opposed to just the channel.&#x20;

#### Recommended use

Get permanent links for MicroBlog (Twitter/X) or InstaMedia (Instagram) posts and link them in Msngr Plus. This **embeds a rich preview of the content**, the same kind you'd see in messaging apps like WhatsApp. You can also use permanent links for MicroBlog injects to **replicate a quote retweet**.

{% content-ref url="/pages/SK5ipF68qYDJh072L7wg" %}
[Msngr Plus](/feature-documentation/designing-and-running/channels/collaboration-based-channels/msngr-plus.md)
{% endcontent-ref %}

{% content-ref url="/pages/jXltBeFvmhtK5WA8j6sY" %}
[MicroBlog (Twitter/X)](/feature-documentation/designing-and-running/channels/popular-channels/microblog-twitter-x.md)
{% endcontent-ref %}

{% stepper %}
{% step %}

#### Right click on the inject you want to link to

<figure><img src="/files/jhByrX9DAqqq5O1ULYlt" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Select `Get permanent link` to copy it to your clipboard

:arrow\_up:As seen in the screenshot above.
{% endstep %}

{% step %}

#### Paste into the body of another inject

<figure><img src="/files/6On5avKVZGVHtzb4EK0N" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### The link will appear as an embedded preview for the player

This simulates WhatsApp link preview and quote retweeting on Twitter/X.

<figure><img src="/files/2rAhQmQ3CYO7cHEFrOCD" alt=""><figcaption><p>Permanent links in the Virtual Desktop</p></figcaption></figure>
{% endstep %}
{% endstepper %}

#### :zap:Things to consider

We recommend adding your permanent links near the end of an exercise build to ensure everything is up-to-date. Bear in mind that **if you export and reimport an exercise file, the permanent links will change and therefore, no longer work** (this is due to the fact that the link uses persona IDs which change during exporting and importing).

**You can use a permanent link 'outside' of Conducttr as long as you are logged into the exercise** e.g. if you're doing a presentation and want to show something specific in Conducttr, you can use the permanent link on one of your slides but make sure you're logged in.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://helpdocs.conducttr.com/feature-documentation/designing-and-running/master-events-list/links.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.