Skip to content

role:list

Display roles and their permissions.

Display roles and their permissions. Use --filter to show only roles with specific permissions or specific role IDs.

Examples

  • role:list --filter='administer nodes'
  • role:list --filter='rid=anonymous'

Options

  • --format=FORMAT. Format the result data. Available formats: csv,json,list,null,php,print-r,sections,string,table,tsv,var_dump,var_export,xml,yaml [default: yaml]
  • --fields=FIELDS. Available fields: ID (rid), Role Label (label), Permissions (perms)
  • --field=FIELD. Select just one field, and force format to string.
  • --filter=FILTER. Filter output based on provided expression. Default field: perms

Global Options

  • -v|vv|vvv, --verbose. Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
  • -y, --yes. Auto-accept the default for all user prompts. Equivalent to --no-interaction.
  • -l, --uri=URI. A base URL for building links and selecting a multi-site. Defaults to https://default.
  • To see all global options, run drush core:global-options.

Aliases

  • rls
  • role-list

Legend

  • An argument or option with square brackets is optional.
  • Any default value is listed at end of arg/option description.
  • An ellipsis indicates that an argument accepts multiple values separated by a space.