> ## 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/index",
  "feedback": "Description of the issue"
}
```

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

</AgentInstructions>

# Topic file parameters

> Topic files are used to define configuration for individual topics.

| Parameter                                                                      | Description                                                                                                                         |
| ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| [access\_filters](/modeling/topics/parameters/access-filters)                  | Limits access to rows in a dataset based on user attributes.                                                                        |
| [ai\_fields](/modeling/topics/parameters/ai-fields)                            | Curates the fields in the topic that are provided to the Omni Agent.                                                                |
| [always\_having\_filters](/modeling/topics/parameters/always-having-filters)   | Applies a filter to aggregated results (measures) in a query using filter syntax.                                                   |
| [always\_having\_sql](/modeling/topics/parameters/always-having-sql)           | Applies a filter to aggregated results in a query using SQL.                                                                        |
| [always\_where\_filters](/modeling/topics/parameters/always-where-filters)     | Applies a filter to all rows in a query using filter syntax.                                                                        |
| [always\_where\_sql](/modeling/topics/parameters/always-where-sql)             | Applies a filter to all rows in a query using SQL.                                                                                  |
| [auto\_run](/modeling/topics/parameters/auto-run)                              | Forces all queries using the topic to require a run click to return new results.                                                    |
| [base\_view](/modeling/topics/parameters/base-view)                            | **Required**. Defines the base view for the topic.                                                                                  |
| [base\_view\_label](/modeling/topics/parameters/base-view-label)               | Defines the display name of the table in the workbook when it is accessed from the topic.                                           |
| [cache\_policy](/modeling/topics/parameters/cache-policy)                      | Defines the cache policy for the topic.                                                                                             |
| [default\_filters](/modeling/topics/parameters/default-filters)                | Applies a filter to all rows in a topic. Filters created using this parameter are visible in workbooks and can be removed by users. |
| [default\_row\_limit](/modeling/topics/parameters/default-row-limit)           | Sets the default row limit for new queries using the topic. Overrides the model-level setting.                                      |
| [description](/modeling/topics/parameters/description)                         | Free text that describes the table.                                                                                                 |
| [display\_order](/modeling/topics/parameters/display-order)                    | Defines the order that topics display in the field picker.                                                                          |
| [extends](/modeling/topics/parameters/extends)                                 | Allows for inheriting and overriding another topic inside of Omni.                                                                  |
| [fields](/modeling/topics/parameters/fields)                                   | Curates the fields available in the topic.                                                                                          |
| [group\_label](/modeling/topics/parameters/group-label)                        | Defines the group the topic belongs to.                                                                                             |
| [hidden](/modeling/topics/parameters/hidden)                                   | Removes the topic from the workbook.                                                                                                |
| [joins](/modeling/topics/parameters/joins)                                     | Declares other views as part of the topic.                                                                                          |
| [label](/modeling/topics/parameters/label)                                     | Defines a display name for the topic.                                                                                               |
| [owners](/modeling/topics/parameters/owners)                                   | A list of email addresses indicating who the owners of the topic are.                                                               |
| [relationships](/modeling/topics/parameters/relationships)                     | Defines a list of topic-level joins.                                                                                                |
| [required\_access\_grants](/modeling/topics/parameters/required-access-grants) | Defines a list of access grants for the topic, which are used to control access.                                                    |
| [sample\_queries](/modeling/topics/parameters/sample-queries)                  | Defines a list of sample queries that could be performed on the topic.                                                              |
| [tags](/modeling/topics/parameters/tags)                                       | Organizes topics by category.                                                                                                       |
| [template](/modeling/topics/parameters/template)                               | Marks a topic as a template only accessible through `extends` and disables model validation.                                        |
| [views](/modeling/topics/parameters/views)                                     | Allows customization of views only in the context of the topic.                                                                     |
| [warehouse\_override](/modeling/topics/parameters/warehouse-override)          | Specifies a different warehouse to use for queries using this topic.                                                                |