Manage Subscription and License

Prev Next

The Subscription page shows your workspace plan, usage, and license. From this page, you can apply a license, sync license updates from Rocket.Chat Cloud, and remove a license.

New self-managed workspaces start on the Starter plan. To upgrade to a premium plan, see Subscribe Your Workspace.

On cloud-hosted workspaces, Rocket.Chat applies your plan's license before handing the workspace over to you. Use this page to check your plan and usage.

Before you begin

You need these permissions:

  • View the Subscription page: manage-cloud

  • Apply or remove a license: manage-cloud and edit-privileged-setting

The admin role has both by default.

To open the page, go to Manage → Workspace → Subscription.

Apply or update your license

From Rocket.Chat 8.7, you can apply or replace a license directly on the Subscription page. Rocket.Chat validates the license against your workspace before applying it, so an invalid license is never applied.

  1. Go to Manage → Workspace → Subscription.

  2. On the plan card, click Manage license.

  3. Add your license in one of these ways:

    • Paste the license key into the License key field.

    • Drag and drop your license file onto the field, or click Upload license file to select it. Only .txt files are supported.

  4. Wait while Rocket.Chat validates the license. When it's valid, the message "This license is valid and ready to apply" appears.

  5. Click Apply license.

If you don't see the changes in your workspace within a few minutes, click Sync license update at the top of the page.

Get a license update from Rocket.Chat Cloud

If your workspace is registered and connected to the internet, you don't need a license file. When your plan changes, for example after you buy a premium plan or more seats, click Sync license update on the Subscription page. The workspace fetches the latest license from Rocket.Chat Cloud.

For air-gapped workspaces, see Apply License in an Air-gapped Workspace.

Remove a license

Removing a license immediately applies the Rocket.Chat Community license, and Community restrictions take effect right away.

  1. Go to Manage → Workspace → Subscription.

  2. On the plan card, click Manage license.

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

  4. Review the confirmation message, then click Apply Community license.

The workspace switches to the Community license. To finish:

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

  • If your workspace is connected to Rocket.Chat Cloud, cancel the license in the Rocket.Chat Cloud portal before you restart. Otherwise, Rocket.Chat Cloud applies the license again when the workspace starts.

Review your plan and usage

The Subscription page includes the following information:

  • Plan card: Your plan, renewal date, and hosting type. Users with the edit-privileged-setting permission also see the workspace Site URL and Hashed Site URL, each with a copy button, and the Manage license link.

  • Includes: The features included in your plan. Click Compare plans to see what other plans include.

  • Seats: The number of user seats used and available. Each unique user occupies one seat, and deactivated users don't occupy seats. For more details, see Seats FAQ and Fair Use Allowance FAQ.

  • Monthly active contacts (MACs): The number of unique omnichannel contacts who engaged with your workspace during the calendar month. For more details, see Monthly Active Contacts.

Community workspaces also show:

  • Apps: The app limits for the workspace. For more details, see Marketplace.

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

  • Active sessions peak: The highest number of active connections in the past 30 days.

Other subscription actions

  • Manage subscription: Click Manage subscription at the top of the page to upgrade your plan or buy more seats. You can also contact the Rocket.Chat Sales team.

  • Cancel subscription: On a Starter workspace, click Cancel subscription to return to the Community plan. For other paid plans, see Manage Your Workspaces.

Next steps

Before you invite users, decide who can create an account and how users sign in. For instructions, see Secure Sign-up and Sign-in.