> ## Documentation Index
> Fetch the complete documentation index at: https://xura.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Entities & relationships

> The semantic layer over your raw data.

An **entity** is a named collection of rows — e.g. `deals`, `contacts`, `products`. A **relationship** links two entities — e.g., `deals.owner_id → contacts.id`.

## How entities get created

* **HubSpot** — each object type (deal, contact, company, ticket) becomes an entity automatically.
* **Uploaded files** — the filename (minus extension) becomes the entity name. Rename in the Data Sources panel.
* **MCP servers** — the server declares entities via its schema.

## Relationships

Xura infers foreign-key-style links from column names + values. You can also declare them explicitly in the Knowledge Graph tab.

## Why entities matter for planning

When you click **Plan from description** on a Flow, the planner sees the list of entity names + their fields. It uses those exact names in the generated `query_data` steps — no hallucination.

Without governance + entity clarity, the planner falls back to generic names ("team\_members") that don't exist in your data → runtime errors.