> ## 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_hidden_unless_access_grants - Model files

> Defines a default 'hidden unless access grants' rule for all topics contained in a model.

Defines a default list of access grants for all topics contained in a model, unless other grants are applied at the topic level. A topic is hidden from a user in the Omni UI unless the user satisfies these access grants. Refer to [`hidden_unless_access_grants`](/modeling/topics/parameters/hidden-unless-access-grants) for details on how this visibility rule works.

<Note>
  This parameter only controls whether a topic is visible in the Omni UI. It does not control data access. Refer to the [Controlling data access guide](/modeling/develop/data-access-control) for parameters that restrict data access.
</Note>

## Syntax

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

## Properties

<ParamField path="default_topic_hidden_unless_access_grants" type="string[]">
  A list of default access grants that control whether all topics in the model are hidden, including [composite topics](/modeling/composite-topics/parameters/hidden-unless-access-grants) that don't set their own `hidden_unless_access_grants`. These values must be the names of access grants defined in the model's [`access_grants`](/modeling/models/access-grants) parameter.

  A topic or composite topic can opt out of the default with `hidden_unless_access_grants: []`.

  <Note>
    Topics created from [CSV/Excel uploads](/analyze-explore/data-input-csvs#modeling-and-promoting-data-input-tables) are automatically exempt from this default. They receive empty access grants (`[]`) at creation time, so the default can't hide an uploaded topic from the user who uploaded it.
  </Note>
</ParamField>

## Examples

```yaml title="Hides all topics unless a user has the is_analyst grant" theme={null}
default_topic_hidden_unless_access_grants: [is_analyst]

access_grants:
  is_analyst:
    user_attribute: omni_user_groups
    allowed_values: [Analyst]
```

```yaml title="A topic that opts out of the default so all users can see it" theme={null}
topics:
  clean_topic:
    hidden_unless_access_grants: []
```