> For the complete documentation index, see [llms.txt](https://docs.verbdata.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verbdata.com/models/building-a-model/relationships.md).

# Relationships

## Create a Relationship 

Once you’ve added at least two tables to the model canvas you will be able to create a relationship between the tables. 

To establish a relationship start by selecting a table on the canvas. A circular menu will appear with options on this table, select “Create Relationship”. 

Upon selecting “Create Relationship” you will have an arrow on your cursor, select the other table.

After two tables are selected, a left panel will slide out where you will then select the columns used to relate the data from the two tables. Next, select the “+” button and the relationship will be established.

![](/files/saEuu24uLFu4b5bgyoml)

## Suggested Relationships 

Verb creates Suggested Relationships for tables in your model that are based on existing relationships in your database and column and tables names. 

You can find suggestions at the top of the left panel or in the table menu on the canvas and left panel. To add the suggested relationship select the blue plus button to the right of the suggested relationship. 

![](/files/MeVlyD3POBJUH0GbPgbL)

{% hint style="info" %}
This button is only visible when there are suggested relationships among the tables added to the model canvas.
{% endhint %}

## Remove Relationships 

To remove a relationship, select the relationship line and then select the trash can that appears on the highlighted line.

When removing a Relationship, Verb will validate that the Relationship is not used in a collection or a transformation. If the Relationship is used in a collection the system will alert you to which collections will be impacted. You cannot remove a relationship used in any step of a transformation.

![](/files/ifOBP80UIccNqDdFpOdt)


---

# 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.verbdata.com/models/building-a-model/relationships.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.