Create sub-accounts

Owner or Admins

For New Relic accounts with Pro or higher subscription levels, you can create a master account with sub-accounts for different applications. This is useful, for example, to limit users to viewing only apps relevant to their group. After the Owner creates one or more sub-accounts, those sub-account's Admins can maintain them like any other New Relic account.

Access to this feature depends on your subscription level.

License keys for sub-accounts

A New Relic Pro (or higher) account serves as the master account with its own license key. Sub-accounts have their own license key (and their own API keys) to keep the sub-accounts and master accounts from sharing any application data.

Create sub-accounts


To create sub-accounts for your existing master account:

  1. From the New Relic menu bar, select (account) > Account settings > Account > Summary.
  2. From Sub-accounts, select Add account.
  3. Type the sub-account name, and select Add this account.
  4. Continue with the procedures to add sub-account users.

If any sub-accounts have already been created, the first account on the Sub-accounts list is the master account.

Set up accounts with SAML SSO


If you set up SAML SSO at the master account level, your sub-account users will also be able to sign in using SSO. For more information, see Configuring SAML with multiple accounts.

New Relic Partners: Authentication to sign in to New Relic is controlled by your partnership. In addition, your account structure and settings affect whether SAML SSO is available and how it applies to your accounts. For more information, see New Relic Partners and SAML SSO.

Add sub-account users

Owner or Admins

In general, individuals who have Admin or User rights on the master account automatically inherit the same rights for sub-accounts. However, in order to receive alert notifications or weekly email reports, or to hide specific applications from a sub-account, they must be explicitly added to the sub-account.

Currently with New Relic Alerts, Admins in the master account do not automatically inherit their Admin rights in sub-accounts. In order to use New Relic Alerts as Admins in sub-accounts, the master account's Owner or Admins must be added to the appropriate sub-accounts and set their permissions as Admins.

When the Owner first adds the sub-account, the Users list automatically appears. To add, edit, or delete individuals for the sub-account later, go to the sub-account's Summary, or start from the master account's Summary:

  1. From the New Relic menu bar, select (account) > Account settings > Account > Summary.
  2. From the master account: From the Sub-accounts list, select the sub-account's link.
  3. From the sub-account's Active users section, select Add user, fill in the user's email, name, role, and title as appropriate, and then select Add this user.
  4. Optional: Change the Owner or Admin roles for the sub-account as appropriate.

To go directly to the sub-account: From the New Relic menu bar, select (account) > Switch account > (selected sub-account).

Update sub-account applications

Owner or Admins

To install a new app for your sub-account:

  1. Make sure you have selected the master account: From the New Relic menu bar, select (account) > Switch account > (master account).
  2. Follow standard procedures to install new applications.


    Change the license key in the existing application's configuration file to move it to another sub-account.

When you change the app's config file to "move" it from one account to another, New Relic treats it as a new app in the new sub-account. New Relic does not move any historical data for the app.

Update sub-account email settings

Owner, Admins, Users, or Restricted Users

To update settings for alert notifications or weekly email for the sub-account's applications:

  1. From the New Relic menu bar, select (account) > Switch account > (sub-account).
  2. From the New Relic APM menu bar, select Applications.
  3. From the sub-account's Applications list, select the app's gear icon, then select Manage alert policy.

For more help

Additional documentation resources include:

If you need additional help, get support at