> ## 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/models/default-topic-required-access-grants",
  "feedback": "Description of the issue"
}
```

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

</AgentInstructions>

# default_topic_required_access_grants

> Defines a default required access grant for all topics contained in a model.

Defines a list of default required [access grant](/modeling/develop/data-access-control) for all topics contained in a model, unless other grants are applied at the topic level. Access grants control data access for topics in a model based on user attributes.

Refer to the [Controlling data access guide](/modeling/develop/data-access-control#overriding-default-topic-access-grants) for an example of overriding a default topic access grant.

## Syntax

```yaml theme={null}
default_topic_required_access_grants: [access_grant_one, access_grant_two, ...]
```

The values provided to this parameter must be the names of access grants defined in the model's [`access_grants`](/modeling/models/access-grants) parameter.

<Note>
  Topics created from [CSV/Excel uploads](/analyze-explore/data-input-csvs#modeling-and-promoting-data-input-tables) are automatically exempt from model-level default access grants. They receive empty access grants (`[]`) at creation time, making them accessible to all users including embed users. This ensures that uploaded CSVs remain accessible without additional configuration.
</Note>

## Examples

```yaml title="Defines finance as the required access grant for topics" theme={null}
default_topic_required_access_grants: [finance]

access_grants:
  nw_region:
    user_attribute: region
    allowed_values: [washington, idaho, oregon, wyoming, alaska]
  finance:
    user_attribute: omni_user_groups
    allowed_values: [Finance]
  marketing:
    user_attribute: omni_user_groups
    allowed_values: [Marketing]
```