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

# required_access_grants

> Defines a list of access grants for the topic, which are used to control access.

Defines a list of access grants for the topic, which are used to control access. The values of this parameter must match the name of an access grant in the model file's [`access_grants`](/modeling/models/access-grants) parameter.

Refer to the [Controlling data access guide](/modeling/develop/data-access-control) for more information and examples.

You can also conditionally allow access by using pipes (`|`) and ampersands (`&`) to create `OR` and `AND` conditions.

## Syntax

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

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

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

## Properties

<ParamField path="required_access_grants" type="string[]">
  An array of access grant names that control access to the topic. Each value must match an access grant defined in the model file. Use `|` for `OR` conditions and `&` for `AND` conditions within the same array element.
</ParamField>

## Examples

```yaml title="Define one required access grant" theme={null}
required_access_grants: [marketing]
```

```yaml title="Grant access if conditions are met for either access grant" theme={null}
required_access_grants: [marketing|sales]
```

```yaml title="Grant access if conditions are met for marketing OR sales AND product" theme={null}
required_access_grants: [marketing|sales&product]
```