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

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

</AgentInstructions>

# required_access_grants

> Limits a user's ability to query a view based on assigned user attributes.

`AND` and `OR` conditions are supported.

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

## Syntax

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

## Properties

<ParamField path="required_access_grants" type="array">
  An array of access grant names, which must already exist in the [model file](/modeling/models/access-grants).

  Use `|` for `OR` conditions and `&` for `AND` conditions.
</ParamField>

## Examples

```yaml title="Single access grant" theme={null}
required_access_grants: [ grant_one ]
```

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

```yaml title="Grant access if grant_one OR (grant_two & grant_three) are met" theme={null}
required_access_grants: [ grant_one|grant_two&grant_three ]
```
