# Subscription Management

The Subscriptions page in Cloudback provides a centralized view of all your subscriptions and allows you to manage how they are assigned to your connected accounts.

## Accessing the Subscriptions Page

1. Log in to the [Cloudback Dashboard](https://app.cloudback.it)
2. Click on **Subscriptions** in the main navigation

## How Units Work

Subscriptions are measured in **units**. Each subscription provides a pool of units, and each backup definition consumes units from that pool when enabled.

### Units per Platform

| Platform     | Unit Cost                                        | Example                              |
| ------------ | ------------------------------------------------ | ------------------------------------ |
| GitHub       | 1 unit per repository                            | 10 repos = 10 units                  |
| Azure DevOps | 1 unit per repository                            | 10 repos = 10 units                  |
| GitLab       | 1 unit per project                               | 10 projects = 10 units               |
| Linear       | 2 units per project in the workspace (minimum 2) | Workspace with 5 projects = 10 units |

For Linear, the unit count is recalculated automatically as projects are added or removed from the workspace.

### How Subscription Capacity Works

Your subscription's total units are shared across all assigned accounts. For example, a 100-unit subscription assigned to two accounts allows a combined total of 100 enabled backups (assuming 1 unit each).

* **Total**: The number of units purchased with your subscription
* **Scheduled**: The number of units currently consumed by enabled backup definitions
* **Available**: Total minus Scheduled - the remaining capacity

When you enable a backup, Cloudback checks whether enough units are available. If not, the backup cannot be enabled.

### Fixed vs Metered Plans

* **Fixed plans**: Have a hard unit limit. You cannot enable more backups than your purchased units allow. If your subscription is downgraded or an account is unassigned, Cloudback may automatically disable backup definitions that exceed the new limit.
* **Metered plans**: Scale automatically with usage. There is no hard cap - billing adjusts based on the number of enabled backups.

### Free Plan

Every connected account gets 1 free backup slot independently - no subscription assignment required. This allows you to back up one repository or workspace per account at no cost. The free plan bypasses the unit count check, so a Linear workspace (which normally costs 2+ units) can still use the free slot.

## My Subscriptions

The Subscriptions page displays a table of all subscriptions associated with your account.

![Subscriptions table](https://2781059148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQEI7SjBF2CddqNXZpCoE%2Fuploads%2Fgit-blob-a82fd31d38e3c09f142dffb7ef8a989bdab916e8%2Fsubscriptions-table.png?alt=media)

The table includes the following columns:

| Column        | Description                                                             |
| ------------- | ----------------------------------------------------------------------- |
| Plan Name     | The subscription plan name, plus free trial status if applicable        |
| Status        | Current status badge (Active or Cancelled)                              |
| Source        | Where the subscription was purchased (GitHub, Azure, Invoiced)          |
| Price         | Subscription price (shows "Free for OSS" for open source subscriptions) |
| Billing Cycle | Monthly, Quarterly, Semi-Annually, Annually, etc.                       |
| Total         | Total units purchased with the subscription                             |
| Scheduled     | Units currently in use (assigned to enabled backups)                    |
| Consumption   | Visual progress bar showing usage percentage                            |
| Assignments   | List of accounts assigned to this subscription                          |
| Actions       | View button to open subscription details                                |

You can export the subscriptions table to CSV using the **Export CSV** button.

## Account Coverage

Below the subscriptions table, the Account Coverage section provides an overview of backup definitions across all your connected accounts.

![Account coverage](https://2781059148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQEI7SjBF2CddqNXZpCoE%2Fuploads%2Fgit-blob-3cbf6888b8a61b28dbd26d698157b1ed2e0dafac%2Faccount-coverage.png?alt=media)

| Column    | Description                                                         |
| --------- | ------------------------------------------------------------------- |
| Account   | Account name with platform icon                                     |
| Total     | Total units available for the account (from assigned subscriptions) |
| Scheduled | Units currently in use by enabled backups                           |
| Coverage  | Visual progress bar showing backup coverage percentage              |
| Plan Type | Shows "Metered" or "Fixed" based on assigned subscription type      |

This overview helps you identify accounts that may need additional subscription capacity or have unused backup slots. You can export this data to CSV using the **Export CSV** button.

## Assigning Subscriptions to Accounts

Subscriptions can be assigned to multiple accounts, allowing you to share a single subscription across different accounts - including accounts from different platforms. This makes it easier to manage backups across your entire infrastructure.

### To Assign a Subscription

1. Navigate to the **Subscriptions** page
2. Locate the subscription you want to assign
3. Click the **View** button in the Actions column to open the subscription details modal
4. In the modal, scroll to the **Account Assignments** section
5. Under "Assign New Account", select an account from the dropdown
6. Click the **Assign** button
7. The account will be added to the assignments list

### To Remove an Assignment

1. Navigate to the **Subscriptions** page
2. Click the **View** button for the subscription you want to modify
3. In the subscription details modal, find the **Account Assignments** section
4. Locate the assignment you want to remove
5. Click the remove (minus) icon next to the assignment
6. Confirm the removal in the warning dialog

> **Note**: Some assignments are non-removable. The account where the subscription was originally purchased through GitHub Marketplace or Azure Marketplace cannot be unassigned. At least one account must remain assigned to each subscription.

## Subscription Details Modal

Clicking the **View** button opens a detailed modal with detailed subscription information.

![Subscription details](https://2781059148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQEI7SjBF2CddqNXZpCoE%2Fuploads%2Fgit-blob-b4ec62a58ac9c0ceee127c8d8556864b49c01282%2Fsubscription-details-modal.png?alt=media)

### Key Metrics

* **Plan Units Purchased**: Number of subscription units purchased
* **Units Purchased**: Total units purchased (Quantity × units per plan)
* **Final Price**: The subscription price after discounts

### Plan Information

* Plan type (Metered or Fixed)
* Start and end dates
* Next billing date
* Free trial status and end date (if applicable)
* Pricing breakdown including base price, add-ons, and discounts

### Account Assignments

Lists all accounts assigned to the subscription with options to add or remove assignments.

### Action Buttons

Depending on the subscription source, you may see buttons to manage your subscription in the original marketplace (GitHub Marketplace, Azure Marketplace, etc.).

## Subscription Sources

Subscriptions can come from different sources:

| Source             | Description                                        |
| ------------------ | -------------------------------------------------- |
| GitHub Marketplace | Subscriptions purchased through GitHub Marketplace |
| Azure Marketplace  | Subscriptions purchased through Azure Marketplace  |
| Credit Card        | Direct purchases through Paddle                    |
| Invoiced           | Enterprise subscriptions with custom billing       |

Each source may have different rules for assignment management. For example:

* **Open Source (OSS) subscriptions**: Account assignments cannot be modified for Open Source subscriptions
* **Marketplace subscriptions**: The original account is automatically assigned and cannot be removed

## Managing Multiple Accounts

You can connect multiple accounts from all supported platforms to a single Cloudback dashboard:

* Each account appears separately in the platform-specific section of the left sidebar
* Use the left navigation to switch between platform views
* A single subscription can cover multiple accounts - including accounts from different platforms

## Managing Multiple Subscriptions

If you have multiple subscriptions, you can:

* Assign each subscription to different accounts for isolated billing
* Assign multiple subscriptions to the same account for increased capacity
* View aggregate usage across all subscriptions

## Troubleshooting

### Cannot Assign Subscription

If you cannot assign a subscription to an account:

1. Verify you have admin access to the target account
2. Check if the subscription has reached its assignment limit
3. Ensure the account is properly connected to Cloudback

### Cannot Remove Assignment

If you cannot remove an assignment:

1. Check if it's the original purchase account (non-removable)
2. Verify the subscription isn't an Open Source subscription
3. Ensure the account doesn't have active backups that exceed the remaining capacity

### Subscription Not Showing

If a subscription isn't appearing in your dashboard:

1. Verify the subscription is active in the marketplace (GitHub or Azure Marketplace)
2. Check that you're logged in with the correct account
3. Contact <support@cloudback.it> if the issue persists

## Learn More

* [Payment Methods](https://docs.cloudback.it/account-and-billing-management/payment-methods) - How to purchase subscriptions
* [Invoiced Customers](https://docs.cloudback.it/account-and-billing-management/invoiced-customers) - Enterprise billing options