Manage Subscription and License

The Subscription page provides workspace administrators with an overview of plan details, usage metrics, and license administration options.

To access this page, go to Manage > Workspace > Subscription.

Permissions required

• View Subscription page: Requires the manage-cloud permission.

• Manage licenses: Requires the edit-privileged-setting and manage-cloud.

Workspace subscription overview

The Subscription dashboard displays the following key information:

• Workspace plan information, renewal date, and hosting type.

• The workspace Site URL and Hashed Site URL.

• The available features for your workspace according to the subscribed plan.

• The number of available user seats on your workspace. Each unique user occupies one seat. Deactivated users do not occupy seats. For further information, see the Seats FAQ, Fair Use Allowance FAQ, and License Application.

• The number of monthly active contacts (MACs), which are unique omnichannel contacts that engaged with your workspace during the calendar month. For details, see Monthly Active Contacts.

Subscription actions

From the Subscription dashboard, you can perform the following actions:

• Sync license update: Forces an immediate synchronization between your workspace and Rocket.Chat Cloud to fetch recent backend license updates.

• Manage subscription: Redirects the workspace admin to the Sales team to upgrade the workspace plan or purchase additional user seats.

• Cancel workspace subscription: Available for Starter workspaces to revert to Community directly. For other paid plans, refer to Cancel a workspace subscription.

Community workspace subscription details

For Community workspaces, you can find the following additional details:

• Apps: View the app limit details for the workspace.

• Active sessions: Total concurrent user connections to the workspace. A single user can be connected multiple times. User presence service is disabled at 200 or more to prevent performance issues.

• Active sessions peak: Highest amount of active connections in the past 30 days.

Manage your workspace license

Starting from Rocket.Chat 8.7, workspace administrators can apply, replace, or remove a license directly from the Subscription page. Rocket.Chat validates every license against your workspace before it is applied, so invalid values are never applied.

Apply or update your workspace license

1. Navigate to Manage > Workspace > Subscription.

2. Click Manage license from the plan details card.

3. Apply your license using one of the following methods:

   1. Paste key: Paste your raw license key directly into the License key field.

   2. Upload file: Drag and drop your .txt license file, or click Upload license file to select it.

4. Wait for real-time validation. Rocket.Chat automatically verifies the license key against your workspace instance.

5. Once the license passes validation, click Apply license.

6. Click Sync license update at the top right of the page to refresh your workspace capabilities immediately.

Remove a license key

1. Navigate to Manage > Workspace > Subscription.

2. Click Manage license from the plan details card.

3. With the current license shown in the License key field, click Remove license.

4. Review the confirmation message. Removing the key immediately applies the Rocket.Chat Community license, and Community restrictions take effect right away.

5. Click Apply community license to confirm.

The workspace immediately switches to the Community license.

• Restart your workspace instance for license removal to fully take effect.

• If your workspace is connected to Rocket.Chat Cloud, cancel the license in the Cloud portal before restarting. Otherwise, Rocket.Chat Cloud reapplies the license when the workspace starts.