Create sub-accounts

Some New Relic paid subscription levels allow you to 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

Your New Relic 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 account 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 dropdown) > 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 dropdown) > 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: (account dropdown) > 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: (account dropdown) > 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

Anyone who uses the sub-account can update their own settings for alert notifications or weekly emails for the sub-account's applications:

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

For more help

Additional documentation resources include:

If you need additional help, get support at