> ## 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/dimensions/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

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

Defines a list of access grants for the dimension, 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}
<dimension_name>:
  required_access_grants: [<grants_and_conditions>]
```

## Properties

<ParamField path="dimension_name" type="object[]">
  The name of the dimension.

  <Expandable title="dimension_name properties" defaultOpen="true">
    <ParamField path="required_access_grants" type="string[]">
      An array of access grant names that control access to the dimension. 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>
  </Expandable>
</ParamField>

## Examples

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

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

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