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

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

</AgentInstructions>

# topic

> Specifies the topic used by the query.

If the query is not based on a [topic](/modeling/topics), this parameter will not be included in the generated query view modeling.

## Syntax

```yaml theme={null}
query:
  topic: <topic_name>
```

## Properties

<ParamField path="query" type="object[]">
  An object containing the individual parameters that make up a query view's query definition.

  <Expandable title="query properties" defaultOpen="true">
    <ParamField path="topic" type="string">
      The name of the topic the query is based on.
    </ParamField>
  </Expandable>
</ParamField>

## Examples

```yaml title="Query based on orders topic" theme={null}
query:
  fields:
    users.age: age
    users.created_at[year]: created_at_year
  topic: orders
```
