> ## Documentation Index
> Fetch the complete documentation index at: https://www.dynamic.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Access Lists

> Allow or restrict access using lists of emails, wallet addresses, or other identifiers. Works with any SDK; scopes and UI customization are SDK-specific.

Access lists let you allow or restrict access based on a predefined list of users—for example, emails, wallet addresses, or other unique identifiers. You manage lists in the Dynamic dashboard; no code is required for basic allow/block behavior.

## Where to configure

Go to [Access Control](https://app.dynamic.xyz/dashboard/fraud-prevention) in your developer dashboard.

## Two outcomes

When you create a gate that uses an access list, you choose one of:

* **Allow Site Access** – Users not on the list are blocked at sign-in (no JWT is issued). Works with any integration; no SDK needed for enforcement.
* **Return scope** – Users on the list get a scope added to their JWT. Use this for fine-grained UI (for example, showing beta features). Reading scopes and customizing the experience is SDK-specific; see the links below.

## Setup

1. Click **Create new gate**.
2. Name your gate.
3. Select the outcome: **Allow Site Access** or **Return scope**.
4. Choose the type of identifier (email, wallet address, or other).
5. Enter the identifier. You can add an alias to keep track of users.
6. Click **Add +** to add the user to the list. Repeat as needed.
7. Save and enable the toggle.

You can create multiple lists (for example, VIPs, beta users, internal users). A user only needs to be in **one** of the lists to pass.

To customize the images shown when a user is blocked or allowed (for example, in the Dynamic widget), see [General Settings](/overview/developer-dashboard/general) in the developer dashboard.

## Advanced usage

For reading scopes in-app please consult the SDKs below:

* [React – Access Lists](/react/gating/access-lists)
* [React Native – Access Lists](/react-native/gating/access-lists)

## API

To manage access lists programmatically, use the [Allowlists API](/api-reference/allowlists/get-all-allowlists-for-a-environment).
