Creating sub-accounts

For New Relic accounts with Pro or higher subscription levels, only the Owner can create a parent account with sub-accounts for different applications. This is useful, for example, to limit users so they can view specific applications and not others. After the Owner creates one or more sub-accounts, their Admins can maintain them like any other New Relic account.

License keys for sub-accounts

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

Note: Sub-accounts must also use their own API key.

Creating sub-accounts

You must be the parent account's Owner in order to add, edit, and delete sub-accounts. If you do not already have a New Relic account, follow standard procedures to create an account that will be the parent. Make sure the parent account has a Pro or higher subscription level.

screen pro/enterprise account.png
(account) > Account settings > Account > Summary: The parent account's Owner can add, edit, and delete parent accounts, their sub-accounts, and their users. Admins can add and delete users for their own accounts.

To create sub-accounts for your existing parent 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 parent account. Sub-accounts appear below it with links.

Setting up accounts with SAML SSO

If you set up SAML SSO at the parent 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.

Adding sub-account users

Individuals who have Admin or User rights on the parent 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.

You must be an Admin for the selected sub-account (or the parent account's Owner) in order to add, edit, and delete users for that sub-account. 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 parent account's Summary:

  1. From the New Relic menu bar, select (account) > Account settings > Account > Summary.
  2. From the parent 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.

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

Updating sub-account applications

You must be an Admin for a sub-account (or the parent account's Owner) in order to add, edit, and delete applications for it. To identify which applications can be viewed from your sub-account:

  1. Make sure you have selected the parent account: From the New Relic menu bar, select (account) > Switch account > (parent 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.

Note: 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.

Updating sub-account email settings

To update alert notification or weekly email settings 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 icon-settings.png, and then select Manage alert policy.

For more help

Additional documentation resources include:

If you need additional help, get support at