• /
  • Log in
  • Free account

User management concepts: groups, roles, and capabilities

Here we'll explain how New Relic users get access to specific capabilities and specific accounts.

Main ways permission is controlled: user type and roles

When it comes to what New Relic features your users can access, there are two main settings at work:

  • The user type: For organizations on New Relic One pricing, your users' user type is a billing factor. The user type is what sets the maximum allowed capabilities a user can access. It's meant to be a fairly long-term setting based on someone's expected New Relic duties.
  • The roles assigned: after a user's user type is decided, roles can be used to more precisely control a user's access. Roles are sets of capabilities, which are the granular New Relic abilities (for example, the ability to modify New Relic APM settings). Roles are assigned to user groups via access grants.

Another way to think about the relationship between a user's user type and their assigned roles: a user's user type overrides all role restrictions. For example: a basic user might be assigned a role that has broad New Relic access, but restrictions related to user type take precedence over any role-granted access.

This doc is focused on role-related access. For information on user type, see User type.

Access grants give user groups access to New Relic

In order for a New Relic user to be able to access any New Relic account or capability, they must be in a group, and that group must have an associated access grant. The access grant is what gives a group of users:

  • Access to a specific role (a role being a set of specific capabilities).
  • Access to a specific account, or to the entire organization.

Organizations with Pro or Enterprise edition can have multiple accounts in their organization, and can create and configure access grants. Standard edition organizations are only allowed a single account in their organization, and don't have the ability to create or configure access grants.

When you initially sign up for New Relic, your organization has some built-in access grants associated with the default User or Admin groups. For example, the Admin group has several access grants that give any user in that group broad New Relic access, including to the higher level organization-related and user-management-related admin capabilities.

New Relic organization and access UI - default access grants

A view of the Organization and access UI, showing how our default groups (Admin and User) have access grants that associate the groups with a) specific roles, and b) either a specific account or the entire organization. (Note that this UI is available only for users on the New Relic One user model.)

Here's a diagram showing how access grants work and how they relate to the broader organization:

New Relic user management diagram

A diagram explaining the concept of how access grants give a user group access to a specific role and a specific account (or the entire organization).

For how to create and manage access grants, see:


For users on our New Relic One user model, a "group" represents a group of users. Putting users in a group allows the managing of permissions for multiple users at the same time. For example, if you're using our automated user management feature, you can import a custom group of users (for example, External consultants) from your identity provider service, and then assign an access grant to that group, giving those users a specific role on a specific account.

A New Relic user requires assignment to at least one group to get access to any capability or account. And that group must also have an access grant.

It's worth noting that groups are not what restrict a user's New Relic permissions: it's the role assigned to the group that contains the actual capabilities.

We have two default groups (see below). And Pro and Enterprise organizations can create custom groups.

Users and groups are located within an authentication domain, which is what controls settings related to how users are added and managed (for example, via SCIM provisioning) and how users log in to New Relic.

Our default user groups

We have two default user groups:

  • User: This group allows a user to use and configure our observability and monitoring features but not perform account-level tasks like managing billing or managing other users. It has access to the All product admin role, which gives access to our observability platform tools, but doesn't have the Organization manager and Authentication manager roles, which give access to the account-level capabilities.
  • Admin: has all capabilities, including the organization-level admin abilities. This is the equivalent of having the standard roles of All product admin, the Billing user, the Organization manager and the Authentication domain manager.

To change a user's group, use the User management UI.


Roles are sets of capabilities. We have our default roles, described below. And Pro and Enterprise edition organizations can create custom roles.

To view roles and their capabilities, go to the Organization and access UI and click Roles. Note that the roles UI shows the account-scoped roles but does not show the organization-scoped roles (Organization manager and Authentication domain manager).

Our standard (default) roles

We have several "standard roles," which are roles that are available by default and that satisfy some commonly needed sets of capabilities.


Note that some of our standard roles have hidden capabilities that are not available for selection when creating a custom role. The only standard roles that can be replicated with a custom role are Standard user and Read only; all others have some hidden capabilities.

Our standard roles include:

Standard roles



All product admin


Provides admin-level access to observability platform features but not organization-level and user management features. In other words, this role includes all New Relic capabilities with the exception of managing users (Authentication domain manager role), managing organization/account-structure settings (Organization manager role), and managing billing (Billing user role).

Note: the Standard user role is essentially the All product admin role minus observability feature configuration capabilities.

Standard user


Provides access to observability platform features, but lacks permissions for configuring those features (for example, ability to configure synthetic monitor secure credentials) and lacks organization-level and user management permissions.

Note: the Standard user role is essentially the All product admin role without that role's ability to configure platform features.

Billing user


Provides ability to manage subscriptions and billing setup, and read-only access to the rest of the platform. For organizations with multiple accounts, billing is aggregated in the primary (first-created) account, which is why assigning this role to that primary account grants billing permissions for the entire organization.

Organization manager


Provides the ability to manage organization settings, including organization structure, name, and preferences. Due to our recent switch to the New Relic One user model, this role currently has few abilities but more will be added over time.

For how to grant this role, see Add user management capability.

Organization read only


Provides the ability to view organization-level settings. For how to grant this role, see Add user management capability.

Authentication domain manager


Provides ability to add and manage users, and configure authentication domains for users on the New Relic One user model. For how to grant this role, see Add user management capability.

Authentication domain read only


Provides the ability to view users in your organization and view the configuration of authentication domains. For how to grant this role, see Add user management capability.

Read only


Provides read-only access to the New Relic platform (except for synthetic monitor secure credentials).

Manage v1 users


For New Relic organizations that existed before July 30 2020 and have users on our original user model, this role lets you manage those "v1" users.

For more about how you'd assign roles to groups and create custom roles, see the user management tutorial.


A role, whether one of our standard roles or a custom role, is a set of capabilities. To view roles and their associated capabilities, use the Organization and access UI.

New Relic user capabilities UI screenshot

A view of the capabilities associated with the All product admin role. When creating a custom role, you can select a custom set of capabilities. Note that the capabilities exposed in the UI may change over time: this screenshot was taken January 2022.

Note that some of the standard roles have hidden capabilities not available for selection when building a custom role. For more detail, see Standard roles. Also note that the roles UI shows account-scoped roles but does not show organization-scoped roles (Organization manager and Authentication domain manager).

For how to set up roles that have custom capabilities, see the user management tutorial.

Manage users

To learn how to add users, assign them to groups, and create custom groups and roles, see Manage users.

Tips for creating access grants

Pro and Enterprise edition organizations can create and configure access grants. (Standard edition organizations don't have to think much about access grants.) To implement access grants well, you'll need to think about what groups you'll need, what roles those groups should have, and what account access those groups should have.

If you have a relatively flat organizational structure, and are okay with all or many of your users having wide administrative access and access to all accounts, you'll probably only need at most a few access grants. For example, you might decide to add new access grants to the existing default Admin or User groups, giving those roles access to other accounts. Or, if you need more granular definition over roles and permissions, you'd create access grants that define new groups that have access to specific roles (either our standard roles or custom-defined roles).

For a tutorial on how to create access grants and create custom roles, see the User management tutorial. For other examples of some common user management tasks, see Example tasks. To see the UI in action, see our user management videos.

Some tips on setting up access grants:

  • It may help to first plan out how your access grants will be organized. How many accounts will you have? What user groups will get access to which roles and which accounts? Will you use our default groups and roles or create your own custom groups and roles?
  • If you've used automated user management to provision users via SCIM, you will have to create access grants to give those users access.
  • A common configuration for organizations with many accounts (roughly 20 or more) is setting up groups with the more organization-scoped roles (Organization manager, Authentication domain manager, and Billing user) on the primary account, and then on other accounts, setting up groups with the more product-scoped roles (like All product admin, Standard user, or custom roles).

User management terms and definitions

For an explanation of how user access to accounts and roles works, see User access explained. Here are some definitions for some of our user management terms:

  • A New Relic organization is the representation of your organization, containing all your accounts, users, and data. For more information, see Organization and account structure.
  • A capability is an ability to use or edit a specific, granular New Relic feature. Examples of capabilities:
    • The ability to modify APM settings
    • The ability to delete alert conditions
  • A role is a set of capabilities. It is what gives a user their permissions. Our default standard roles have various capability sets, and you can create custom roles that have a custom set of capabilities. See some specific New Relic capabilities.
  • A user group has one or more roles associated with it. You assign your users to a group. We have default user groups (Admin and User), and you can make your own groups.
  • An access grant is what grants a user group access to roles and to specific New Relic accounts. An access grant essentially states, "This group is assigned this role on this New Relic account." Adding a user to a group doesn’t do anything unless that group is included in an access grant.
  • An authentication domain contains a set of users who are added to New Relic and who log in to New Relic in the same way. For example, you may have one authentication domain for users who log in via username/password and another authentication domain for users who log in via SAML.
  • If a user is a basic user, this takes precedence over any role-related limitations. For more on this, see Basic user and roles.
Create issueEdit page
Copyright © 2022 New Relic Inc.