# Create a relationship

With Freelucy open on your primary element, the canvas shows a single CI in the center with two connection points — a left circle for upstream and a right circle for downstream.

<figure><img src="https://files.readme.io/cf10e91-freelucy-highlighted.png" alt="The primary element with upstream and downstream connection points highlighted"><figcaption></figcaption></figure>

***

## Step by step

1. In the sidebar, click the **Select table** box.
2. Type the name of the table that contains the element you want to map — for example, *Portfolio Management*.
3. Pick the target element from the list. For hierarchical tables, expand to find the right one, or use the search box.
4. **Drag** the element toward the primary element. An **orange ring** appears around the left circle, the right circle, or both — that's Freelucy showing you which connections are valid.
5. Hover over the circle that matches the direction you want. It turns solid orange.
6. If more than one relationship type is valid, a popup appears. Pick the one you want — for example, *Conformant*.

   <figure><img src="https://files.readme.io/ce9ecfd-map_rel-type.png" alt="Pick a relationship type from the popup"><figcaption></figcaption></figure>
7. Click **Done**.

The new connection appears as a **dark blue line** between the two elements. Dark blue means staged but not yet committed.

<figure><img src="https://files.readme.io/0c26c1d-map_rel-uncommited_change.png" alt="A staged relationship shown as a dark blue line"><figcaption></figcaption></figure>

***

## Reading the canvas

| Visual cue                      | What it means                                                      |
| ------------------------------- | ------------------------------------------------------------------ |
| **Orange ring** around a circle | Valid drop target — the relationship is allowed by your metamodel. |
| **Solid orange** circle         | The relationship will be created here when you release the mouse.  |
| **Dark blue** line              | Staged. Will be persisted on commit.                               |
| **Standard** line               | Already committed and exists in ServiceNow.                        |

***

## What's next

* [Create multiple relationships at once](/freelucy/work-in-the-app/create-multiple.md)
* [Commit your changes](/freelucy/work-in-the-app/commit-changes.md)


---

# Agent Instructions: 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:

```
GET https://docs.ins-pi.com/freelucy/work-in-the-app/create-relationship.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.