> For the complete documentation index, see [llms.txt](https://docs.ins-pi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ins-pi.com/freelucy/work-in-the-app/data-hub.md).

# Find records with the Data Hub

The Data Hub is the drawer you source records from. Open it to search the tables that make sense for your primary element, browse a record tree, and add one or many records as relationships.

{% hint style="warning" %}
🖼️ **Screenshot needed — `v26-data-hub-drawer.png`** The Data Hub drawer open beside the editor, showing the suggested-tables panel and a record tree.
{% endhint %}

## Open the Data Hub

Open the Data Hub from the editor. It opens as a drawer alongside your current view and stays out of the way of the canvas.

## Find a record

1. The Data Hub suggests tables based on your primary element. Search to narrow them.
2. Expand a table to browse its records as a tree, or search within it.
3. Records that are valid to relate to your primary element are the ones YouDesign Freelucy lets you add.

## Add records

Once you have found the record or records you want:

* **Add to a side directly.** Use a record's **Add to Upstream** or **Add to Downstream** action. Freelucy resolves the relationship type, asking you only when more than one type applies.
* **Drag onto a drop target.** Drag a record out of the Data Hub. Valid drop targets light up in your current view. Where those targets are depends on the view, so see the [view guides](/freelucy/views-in-depth/classic.md) for specifics.

## Add many at once

You do not have to add records one by one.

1. Hold **Ctrl** or **Cmd** and click each record you want. Selected records highlight.
2. Add them all with the **Add to Upstream** or **Add to Downstream** action, or drag the whole selection onto a valid drop target.

{% hint style="warning" %}
🖼️ **Screenshot needed — `v26-data-hub-multiselect.png`** The Data Hub with several records multi-selected and the Add to Upstream / Downstream action visible.
{% endhint %}

See [Create multiple relationships at once](/freelucy/work-in-the-app/create-multiple.md) for the full walkthrough.

{% hint style="info" %}
**Valid sides light up as you drag.** While you drag from the Data Hub, every view highlights the sides and drop zones your metamodel allows. If a side does not light up, that relationship is not permitted for the records you picked.
{% endhint %}

***

## 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)
* [Choose a view](/freelucy/get-started/choose-a-view.md)


---

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

```
GET https://docs.ins-pi.com/freelucy/work-in-the-app/data-hub.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.