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

# hidden_unless_access_grants - Topics

> Hides the topic from users who don't satisfy the listed access grants, without blocking data access.

Hides the topic from users who don't satisfy the listed access grants, without blocking data access. For a user who doesn't satisfy the listed grants, the topic is removed from the Omni UI, the same way [`hidden: true`](/modeling/topics/parameters/hidden) removes a topic.

Unlike `hidden`, a user who satisfies the grants sees the topic normally. Existing queries and dashboard tiles built on the topic continue to work for users who don't satisfy the grants.

<Warning>
  `hidden_unless_access_grants` only curates which topics a user can see in the Omni UI - it does not control data access. A user who knows the topic name can still query it through the API, and the topic's underlying views and fields remain queryable on their own. Use [`required_access_grants`](/modeling/topics/parameters/required-access-grants) to block data access.
</Warning>

## Syntax

```yaml theme={null}
hidden_unless_access_grants: [<grant_name>]

# OR condition
hidden_unless_access_grants: [<grant_one>|<grant_two>]

# AND/OR conditions
hidden_unless_access_grants: [<grant_one>|<grant_two>&<grant_three>]
```

## Properties

<ParamField path="hidden_unless_access_grants" type="string[]">
  An array of access grant names that control whether the topic is offered to a user. Each value must match an access grant defined in the model file's [`access_grants`](/modeling/models/access-grants) parameter.

  Use `|` for `OR` conditions and `&` for `AND` conditions within the same array element, using the same syntax as [`required_access_grants`](/modeling/topics/parameters/required-access-grants). A grant name that doesn't match an existing access grant hides the topic from everyone.
</ParamField>

## Limitations

This parameter does not apply to [composite topics](/modeling/composite-topics).

## Examples

```yaml title="Hide a topic unless a single access grant is satisfied" theme={null}
topics:
  cdp_legacy:
    hidden_unless_access_grants: [is_cdp_allowed]
```

```yaml title="Hide a topic unless one of two access grants is satisfied" theme={null}
hidden_unless_access_grants: [marketing|sales]
```

```yaml title="Hide a topic unless marketing OR sales AND product is satisfied" theme={null}
hidden_unless_access_grants: [marketing|sales&product]
```