> For the complete documentation index, see [llms.txt](https://docs.wayfinders.network/apps-and-tools/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wayfinders.network/apps-and-tools/wayfinder-platform/making-connections.md).

# Making Connections

Hover over any content on the canvas, and at the bottom of the popup panel will be green 'connect from' and 'connect to' buttons. Use these to make a connection (link) between two items on the canvas.

<figure><img src="/files/mkF3VIaCKpMg9j8VY3ZN" alt="" width="561"><figcaption></figcaption></figure>

Note: clicking these buttons will open an embedded window and may require you to login to StoryKeeper to verify that you have permission to make connections on the canvas.

Once both a "from" and "to" have been selected, you are then able to add any details you want (including #hashtags and @mentions), optionally select to hide your name and then confirm the connection...

<figure><img src="/files/WOKP0jbQZdUanDfN0dj3" alt=""><figcaption></figcaption></figure>

After a few seconds you should see a message saying the connection was successful and that it will be displayed the next time you refresh the WayFinder canvas web page. You can then close the window by clicking anywhere on the canvas.

### Removing a Connection

You can remove any connections you have made by hovering over the connection and clicking the red "remove connection" button at the bottom of the popup panel. As with making a connection, this will open an embedded window where you can confirm that you want to delete the connection (or be shown a message that you do not have permission to do so if you are trying to remove a connection that was created by another user)

### Updating Connections

At this point in time there is no direct way to edit/update an existing connection. Instead, you need to repeat connecting 'to' and 'from' the two items on the canvas and enter/update any text you want to appear in the details field (the details field will be blank, so you will need to copy n paste text from the existing connection if you still want to use that). Once the updated connection is made it will overwrite the existing connection.

### Connection Directions

Although it can be activated, canvases by default do not display a connection arrow to depict the direction of the connection, ie the content being connected 'to'. It is only possible for a single user to create one connection in a certain direction between two items on the canvas, ie Item A --> Item B. You can, however, create another connection in the opposite direction between the same two items, ie Item B --> Item A.

To be clear, multiple connections can be made between two items in the same direction by **different** users. The users name will appear on their connection (see screenshot below).

### Connection Colours

If necessary, canvases can be customised such that connections that have been made by users can be distinguished from connections that are automatically generated when "clustering". In the example screenshot below, the violet-coloured connection has been created by Tim (with Tim's name being overlaid on the connection), whilst the grey connections are automatically generated when clustering content containing the hashtag ''#coaching"...

<figure><img src="/files/FuK2S8572E4Nvw0hFNZP" alt="" width="416"><figcaption></figcaption></figure>


---

# 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://docs.wayfinders.network/apps-and-tools/wayfinder-platform/making-connections.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.
