---
title: Subscription commands
source: https://docs.newrelic.com/docs/new-relic-solutions/build-nr-ui/nr1-cli/nr1-subscription
---

To manage your Nerdpack subscriptions, use the commands below. You can click any command to see its usage options and additional details about the command.

| Command                                            | Description                                            |
| -------------------------------------------------- | ------------------------------------------------------ |
| [`nr1 subscription:list`](#nr1-subscriptionlist)   | Lists all the Nerdpacks your account is subscribed to. |
| [`nr1 subscription:set`](#nr1-subscriptionset)     | Subscribes your account to a Nerdpack and channel.     |
| [`nr1 subscription:unset`](#nr1-subscriptionunset) | Unsubscribes your account from a Nerdpack.             |

## `nr1 subscription:list` [#nr1-subscriptionlist]

### See your subscription [#nr1-subscriptionlist-see]

Lists all the Nerdpacks your account is subscribed to. Your account is linked to your API key.

### Usage

`$ nr1 subscription:list`

### Options

| `--profile=PROFILE` | The authentication profile you want to use. |
| ------------------- | ------------------------------------------- |
| `--verbose`         | Adds extra information to the output.       |

## `nr1 subscription:set` [#nr1-subscriptionset]

### Subscribe to a Nerdpack [#nr1-subscriptionset-subscribe]

Subscribes your account to a specific Nerdpack and channel. This command can be run with a Nerdpack UUID or within a specific Nerdpack folder. By default, the command uses the Nerdpack ID in `package.json` and subscribes to the STABLE channel.

An account can only be subscribed to one Nerdpack and channel at a time.

### Usage [#nr1-subscriptionset-usage]

`$ nr1 subscription:set`

### Options [#nr1-subscriptionset-options]

| `-i, --nerdpack-id=NERDPACK_ID` | Specifies the Nerdpack to subscribe to. By default, the command will use the one in `package.json`. |
| ------------------------------- | --------------------------------------------------------------------------------------------------- |
| `-c, --channel=DEV/BETA/STABLE` | Specifies the channel to subscribe to. [`default: STABLE`]                                          |
| `--profile=PROFILE`             | The authentication profile you want to use.                                                         |
| `--verbose`                     | Adds extra information to the output.                                                               |

### Aliases [#nr1-subscriptionset-aliases]

-   `$ nr1 nerdpack:subscribe`

## `nr1 subscription:unset` [#nr1-subscriptionunset]

### Unsubscribe from a Nerdpack [#nr1-subscriptionunset-unsubs]

Unsubscribes your account from a specific Nerdpack. When this command is executed within a Nerdpack folder, the Nerdpack ID from `package.json` is used by default.

### Usage [#nr1-subscriptionunset-usage]

`$ nr1 subscription:unset`

### Options [#nr1-subscriptionunset-options]

| `-i, --nerdpack-id=NERDPACK_ID` | Specifies the Nerdpack to subscribe to. By default, the command will use the one in `package.json`. |
| ------------------------------- | --------------------------------------------------------------------------------------------------- |
| `--profile=PROFILE`             | The authentication profile you want to use.                                                         |
| `--verbose`                     | Adds extra information to the output.                                                               |

### Aliases [#nr1-subscriptionunset-aliases]

-   `$ nr1 nerdpack:unsubscribe`
-   `$ nr1 subscription:delete`
-   `$ nr1 subscription:remove`
-   `$ nr1 subscription:rm`