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

# astro organization role list

<Info>
  This command is only available on Astro.
</Info>

View a list of all roles in an Organization.

## Usage

Run `astro organization role list` to view a list of the custom and default user roles in your Organization and their IDs. By default, only custom roles are displayed. To create a custom role, see [Create and assign custom Deployment roles](/docs/astro/customize-deployment-roles)

If you want to view the Astro-defined user roles and their IDs, you need to add the `--include-default-roles` flag. For example,

```sh wrap theme={null}

astro organization role list --include-default-roles

```

## Options

| Option                    | Description                                                                          | Possible Values                  |
| ------------------------- | ------------------------------------------------------------------------------------ | -------------------------------- |
| `--include-default-roles` | Display the Astro-defined [user roles](/docs/astro/user-permissions) in the organization. | Any of the available user roles. |

## Output

| Output        | Description                     | Data Type |
| ------------- | ------------------------------- | --------- |
| `NAME`        | The name of the role.           | String    |
| `ID`          | The custom role ID.             | String    |
| `DESCRIPTION` | A description of the user role. | String    |