> For the complete documentation index, see [llms.txt](https://docs.kumu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kumu.io/frequently-asked-questions/how-do-i-open-a-sub-system-when-clicking-on-an-element.md).

# How do I open a sub-system when clicking on an element?

This guide describes how to add a second "layer" of elements + connections to your map that only appear when double-clicking a certain element. You're essentially linking an element to another map in the same project through a [URL field](/guides/fields.md#url). This allows you to add additional data to your map, that might not always need to be visible in the main map.&#x20;

<figure><img src="/files/YrgiJTMeTLqNytYsoKIC" alt=""><figcaption><p>Double-click an element to access a sub-system</p></figcaption></figure>

**Here are the steps to do so:**&#x20;

1. Create your main map, as you want it to be visible to your viewer upon opening the Kumu project (this is your first "layer")
2. Copy the URL of this main map from the browser bar
3. Click on the first dropdown in the top-left corner of your project, and choose "+ New Map"
4. Create the second map that shows what you want it to look like when someone double-clicks an element (this is your second "layer")
5. Click to add a map description to your second map and write "Return to main map". [Hyperlink these words](/guides/profiles/markdown.md) with the URL you copied at step 2
6. Then copy the URL of this second map directly from the browser bar
7. Go back to your main map (top-left corner dropdown) and add a field called "URL" to the element you want to be able to double-click
8. Paste the URL from step 6 as the value in that field
9. Now if you *double-click* that element on your map, it'll navigate you to the other map

{% hint style="info" %}
Looking to make this feature even more interactive? Add a[ Lightbox](/guides/lightbox.md) URL in the URL field (step 8). This way, when you double-click the element, a popup will appear displaying your subsystem—easily dismissible with a quick click of the X in the top-right corner.
{% endhint %}

You can find the example map from the visual above [by clicking here](https://kumu.io/AlexVipond/sub-system-demo).


---

# 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.kumu.io/frequently-asked-questions/how-do-i-open-a-sub-system-when-clicking-on-an-element.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.
