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

# default_topic_required_access_grants - Model files

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

Defines a list of default required [access grants](/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, ...]
```

## Properties

<ParamField path="default_topic_required_access_grants" type="string[]">
  A list of default required access grants for all topics in the model, including [composite topics](/modeling/composite-topics/parameters/required-access-grants) that don't set their own `required_access_grants`. These values 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>
</ParamField>

## 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]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.