# `userMenu`

The user menu is a navigation menu that displays in the far right side of the navbar.
Users can click the user avatar and a dropdown menu displays with the avatar, the user's email address, links to pages you can configure, and a log out option.

![Screenshot of the user menu with the dropdown displayed](/assets/user-menu.e0dbaa3efc8a53e99eb0ae96505bcfb307a04521e9963a0640d814899e1b92d1.d96f5373.png)

You must also have `sso` and either `rbac` or `requiresLogin` configured for the userMenu to display.

## Options

| Option | Type | Description |
|  --- | --- | --- |
| hide | boolean | Specifies if the User menu should be hidden.
Only required if you do not add any other options to the configuration.
Default: `false`. |
| hideLoginButton | boolean | Specifies if the login button that displays in the far right side of the navbar should be hidden.
Default: `false`. |
| items | [Item](#item-object) | List of links in the User menu dropdown. |


### Item object

| Option | Type | Description |
|  --- | --- | --- |
| page | string | **CONDITIONALLY REQUIRED.** Path to the file which represents the page to link to.
Mutually exclusive with the `href` option.
If you use the `page` option, and do not include the `label` option, the text for the link on the sidebar will match the level 1 heading of the page. |
| href | string | **CONDITIONALLY REQUIRED.** URL to link to.
Mutually exclusive with the `page` option.
If you use the `href` option, and do not include the `label` option, the text for the link on the sidebar will match the `href` option's value. |
| label | string | Link text displayed for the item. |
| labelTranslationKey | string | Link text key for the item used for [localization](/docs/realm/config/l10n). |
| external | boolean | Open link in new browser tab.
Default is `false`. |


## Examples


```yaml
userMenu:
  hide: false
  hideLoginButton: true
  items:
    - href: /my-settings/
      label: Settings
```

## Related options

- View options for adding more links to the navbar in the [`navbar`](/docs/realm/config/navbar) configuration reference.
- Configure [`sso`](/docs/realm/config/sso) and either [`rbac`](/docs/realm/config/rbac) or [`requiresLogin`](/docs/realm/config/requires-login) to display the user menu in your navbar.


## Resources

- Learn more about how to [configure RBAC](/docs/realm/access) in the how-to documentation.
- Follow steps for [configuring SSO](/docs/realm/reunite/organization/sso/configure-sso) in the how-to documentation.
- Discover how RBAC works in Redocly products in the [RBAC](/docs/realm/access/rbac) conceptual documentation.