> For the complete documentation index, see [llms.txt](https://olab4.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://olab4.gitbook.io/help/basic-topics/links.md).

# Links

## Overview

Links are the connections between Nodes, that determine which path you can take through the map. Kinda like join-the-dots. The arrow in a Link shows the direction that you can move along the Link. There may be a Link in both directions between two Nodes.&#x20;

We have a [help page from OLab3](https://openlabyrinth.ca/working-with-link-labels/) -- this explains some of the basic principles, which work the same in OLab4. <br>

![](/files/-LsdyaSDOIsXHehSOe1l)

{% hint style="info" %}
Note that there has been a subtle change in how you now drag/drop a Link connection between Nodes. You no longer need to hold down the mouse button as you do so: simply click once on the small Link icon and then click once on the title bar of the destination Node.&#x20;
{% endhint %}

Normally, when you are playing a Map, you can see which Nodes you can visit next because the Link shows the title of the Node it points to. <br>

![](/files/-Lsdz5gV0rhufQDm2g-2)

But you can also change the label on a Link…<br>

![Link Editor on link from Page](/files/-Lsdz_wYehCYexibhW1u)

Simply click on the arrow in the middle of the Link to bring up the Link Editor. We have made this link red so you can see which one we are editing.&#x20;

…and this now shows up with a Link, or button, that is named by its label. This can be useful at times. <br>

![Player view from Page 2. ](/files/-Lse-Q8OkWpz8hwxIxz1)

{% hint style="info" %}
You can play that demo example at <https://player.olab4.net/1462/0>
{% endhint %}

## Link Order

Normally, the Links from a Node are presented in the order in which they were created. As the author, you can change this order.&#x20;

{% hint style="warning" %}
Check whether this works yet or not
{% endhint %}

* Ordered -- the order can be preset by the map author
* Random -- the order can be randomized, changing each time the Node is visited
* Random, select one -- only one of the Links is shown but chosen randomly each time

## Link Style

Most commonly, Links are shown as a series of buttons at the bottom of a Node. The author can also change the Link style to a simple hyperlink. <br>

A Link may be marked as ‘Follow Once’. This means that the user can only pass along that Link once during a session. If the user returns to that Node, the choice to pass along that same Link is no longer visible. <br>

A Link can also be **hidden**. This means that it is not usually shown as a choice to the person playing the map. But in certain situations, you can still travel along that Link. eg. you can be directed along it by a Course Director, during group play within a Course. <br>


---

# 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://olab4.gitbook.io/help/basic-topics/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.
