# How relationships work in Freelucy

Freelucy opens on a single CI — your **primary element**, shown in the center of the canvas. From there, you drag other elements onto the primary element to create relationships, drag connections to remap them, or drag connections off to delete them.

Nothing is written to your CMDB until you click **Commit Changes**. Until then, every edit is a stage on the canvas.

## The mental model

* **Primary element.** The record you opened Freelucy from. It sits in the center.
* **Connection points.** Two circles on the primary element — left for upstream, right for downstream.
* **Picker (sidebar).** Choose a target table, then drag elements from it onto the primary element.
* **Canvas.** Where you stage edits visually.
* **Commit.** A two-step gate: stage edits → review → commit to ServiceNow.

{% hint style="info" %}
**You can only map allowed relationships.** Freelucy shows tables and relationship types that are defined as Suggested Relationships or approved by your administrator. If you need a relationship that's not available, ask your administrator to add it. See [Manage suggested relationships](/freelucy/configuration/suggested-relationships.md).
{% endhint %}

***

## Open Freelucy

1. Open the application navigator and filter for the table that holds your starting CI — for example, `cmdb_ci_business_capability`.

   <figure><img src="https://files.readme.io/0b8f28c-fl-how_to_use_update1.png" alt="Filter the application navigator for a CI table"><figcaption></figcaption></figure>
2. Open the record you want to map relationships from.

   <figure><img src="https://files.readme.io/fcea7f2-fl-how_to_use_update2.png" alt="Open a record from the table view"><figcaption></figcaption></figure>
3. Click **Edit Relationships** on the form.

   <figure><img src="https://files.readme.io/d6d7997-fl-how_to_use_update3.png" alt="The Edit Relationships button on a record"><figcaption></figcaption></figure>

The Freelucy canvas opens with your record as the primary element.

<figure><img src="https://files.readme.io/ff3861b-fl-how_to_use_update4.png" alt="The Freelucy canvas with the primary element"><figcaption></figcaption></figure>

***

## What's next

* [Create a relationship](/freelucy/work-in-the-app/create-relationship.md)
* [Create multiple relationships at once](/freelucy/work-in-the-app/create-multiple.md)
* [Remap a relationship](/freelucy/work-in-the-app/remap-relationship.md)
* [Delete a relationship](/freelucy/work-in-the-app/delete-relationship.md)
* [Commit your changes](/freelucy/work-in-the-app/commit-changes.md)
* [Inspect, navigate, and share](/freelucy/work-in-the-app/inspect-navigate-share.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/usage.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.
