> ## 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.

# 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\_context](/modeling/topics/parameters/ai-context)                                     | Free text that can provide context about a topic to the Omni Agent.                                                                                                                     |
| [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)                                              | Restricts which fields can be queried 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.                                                                                                                                                    |
| [hidden\_unless\_access\_grants](/modeling/topics/parameters/hidden-unless-access-grants) | Hides the topic from users who don't satisfy the listed access grants, without blocking data access.                                                                                    |
| [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.                                                                                                                  |
| [skills](/modeling/topics/parameters/skills)                                              | Defines a set of instructions for the Omni AI that users can trigger with a button click. **Scheduled to be deprecated in favor of [skills](/ai/skills) created from the Skills page**. |
| [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.                                                                                                                    |
| [week\_start\_day](/modeling/topics/parameters/week-start-day)                            | Overrides the model-level week start day for queries scoped to the topic.                                                                                                               |