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

# Link Zite database records

> Link records across tables to assign or reference existing records, keeping your data organized and consistent.

## How it works

Linked records connect rows across tables in the same database. Instead of typing the same information in multiple places, you can select an existing record from another table and keep the relationship consistent.

The easiest way to create these relationships is to ask the [Database Agent](/help/database/getting-started/database-agent) in natural language. The agent can inspect your existing tables, add linked-record fields, and tell you when a relationship already exists.

For example, in a `Line-items` table, each row can link to the matching quote in a `Quotes` table. When you add a line item, you select the quote it belongs to, such as `Q-0001` or `Q-0002`. This keeps quote details in one table while letting each quote collect multiple line items.

<Frame>
  <img src="https://mintcdn.com/zite/Pss_5tNLtzAVU3Ul/help/images/database/linked-records.webp?fit=max&auto=format&n=Pss_5tNLtzAVU3Ul&q=85&s=324cf9604fb15a054f92acb6789d308d" alt="Line-items table linked to a Quotes table by quote number" width="4170" height="1673" data-path="help/images/database/linked-records.webp" />
</Frame>

## Create relationships with the Database Agent

Click `Agent` at the top of your database, then describe the relationship you want to create.

Use table and field names when you know them:

* "Create a linked-record field called Quote on Line-items that links to Quotes."
* "Set up a relationship between Quotes and Line-items so each line item belongs to one quote."
* "Set up a relationship between Tasks and Projects so each task belongs to one project."
* "Add a Company field to Contacts that links each contact to a company."
* "Check whether Lessons is already linked to Courses, and create the relationship if it is missing."

The agent can also confirm existing relationships. For example, if a relationship already exists, it can tell you which fields connect the tables instead of creating duplicates.

<Note>
  Changes that write data or update your database schema require your approval before they run.
</Note>

### Common use cases

* **Employee Records:** Assign employees to managers, departments, or teams
* **Quotes and invoices:** Link line items to a quote or invoice
* **Project Management:** Link tasks to a specific project or team member
* **Sales:** Link contacts, companies, deals, and orders
* **Event Planning:** Assign attendees to sessions, workshops, or ticket types
* **Inventory Management:** Tag stock items to suppliers or product categories

## Link records manually

You can also create linked-record fields yourself from the table grid.

<Steps>
  <Step title="Add a new column">
    Click `+ Add field` and choose `Link to table`.

    <img src="https://mintcdn.com/zite/gF_N3ByhVWhGiZlx/help/images/Screenshot2026-03-30at5.38.02PM.png?fit=max&auto=format&n=gF_N3ByhVWhGiZlx&q=85&s=3abb841f1ae445d40e554effb4153b99" alt="Screenshot 2026 03 30 At 5 38 02 PM" width="2617" height="1389" data-path="help/images/Screenshot2026-03-30at5.38.02PM.png" />
  </Step>

  <Step title="Set details">
    Enter a **Title** or column name, then `Choose a table` and click `Create`.

    <img src="https://mintcdn.com/zite/gF_N3ByhVWhGiZlx/help/images/Screenshot2026-03-30at5.38.17PM.png?fit=max&auto=format&n=gF_N3ByhVWhGiZlx&q=85&s=1911d27d9588d964d9756a9676b2b547" alt="Screenshot 2026 03 30 At 5 38 17 PM" title="Screenshot 2026 03 30 At 5 38 17 PM" style={{ width:"51%" }} width="768" height="521" data-path="help/images/Screenshot2026-03-30at5.38.17PM.png" />

    That's it! You can now pick a record from a dropdown.

    <Warning>
      You can only select tables from the same database.
    </Warning>
  </Step>

  <Step title="Disable multiple record linking (Optional)">
    By default, this field `Allows linking to multiple records`, meaning you can reference more than one record in a field.

    <img src="https://mintcdn.com/zite/gF_N3ByhVWhGiZlx/help/images/Screenshot2026-03-30at5.40.58PM.png?fit=max&auto=format&n=gF_N3ByhVWhGiZlx&q=85&s=de029f4f0a876d5f4a0a8bd498cb2cb4" alt="Screenshot 2026 03 30 At 5 40 58 PM" title="Screenshot 2026 03 30 At 5 40 58 PM" style={{ width:"53%" }} width="731" height="124" data-path="help/images/Screenshot2026-03-30at5.40.58PM.png" />

    If you only want to link a single record, simply untoggle this option.
  </Step>
</Steps>

## Tips for setting up relationships

* Link to the table that owns the source record. For example, link Line-items to Quotes, Tasks to Projects, Orders to Customers, or Lessons to Courses.
* Use clear field names like `Quote`, `Customer`, `Project`, `Course`, or `Assigned to`.
* Allow multiple linked records when one record can relate to several records, such as a project with many team members.
* Disable multiple record linking when each record should only point to one related record, such as one task belonging to one project.
* Use [Lookup fields](/help/database/configure-database/lookup-field) when you want to display information from the linked record in the current table.

<div className="zite-related-topics">
  <a href="/help/database/getting-started/database-agent">Database Agent</a>
  <a href="/help/database/configure-database/lookup-field">Lookup Field</a>
  <a href="/help/database/configure-database/manage-fields">Manage Fields</a>
</div>
