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

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.omni.co/feedback

```json
{
  "path": "/modeling/topics/parameters/joins",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# joins

> Declares other views as part of the topic.

<Note>
  Topics created from [data input tables or uploaded CSV/XLSX files](/analyze-explore/data-input-csvs) can't be joined to other data.
</Note>

Declares other views as part of the topic. To include multiple tables, nest the table under the table it joins through.

<Tip>
  The final table in each node - specifically, those without children - requires an empty bracket pair `{}`
</Tip>

## Syntax

```yaml theme={null}
joins:
  <view_name>:
    <nested_view_name>: {}
  <another_view_name>: {}
```

## Properties

<ParamField path="joins" type="object">
  A nested object structure that declares which views to include in the topic. Views are nested under the views they join through. Final views in each branch must end with an empty object `{}`.
</ParamField>

## Examples

```yaml theme={null}
joins:
  inventory_items:                  # Includes inventory_items in the topic
    products:                       # Joins products to inventory_items
      distribution_centers: {}      # Joins distribution_centers to products
  users: {}                         # Includes users in the topic
```