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

> Reference documentation for the astro organization role list command.

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