> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bytebase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage License

Bytebase offers [3 pricing plans](https://www.bytebase.com/pricing): `Free`, `Pro`, `Enterprise`.

| Plan           | Deployment         | Users     | Pricing         |
| -------------- | ------------------ | --------- | --------------- |
| **Free**       | Self-host or Cloud | Up to 20  | Free            |
| **Pro**        | Cloud only         | Unlimited | \$20/user/month |
| **Enterprise** | Self-host or Cloud | Custom    | Custom          |

<Info>
  **Pro plan is cloud-only.** Self-hosted deployments require an Enterprise license. Existing Pro self-host licenses are grandfathered. Self-hosted Free instances can start a [14-day Enterprise trial](https://www.bytebase.com/contact-us/).
</Info>

<Note>
  Running more than one self-hosted Bytebase replica requires HA to be enabled in the license. If multiple replicas are detected without HA enabled, Bytebase disables backend runners for safety. As a result, background operations such as rollout task execution, plan checks, schema sync, and other scheduled runners will stop progressing until you scale back to a single replica or enable HA in the license.
</Note>

## How Users Are Counted

Two kinds of users count against your plan's user limit, sharing the same seats:

* **Workspace users** — members added to the workspace.
* **Active VCS users** — non-bot pull request / merge request authors observed by `bytebase-release` workflows on GitHub, GitLab, and Bitbucket. An author stays active for 90 days after they were last seen, then drops off automatically. Bytebase relies on the `bytebase-release` workflow to exclude bot accounts before reporting authors.

When the combined count reaches your seat limit, Bytebase stops admitting new active VCS users — the release check no longer counts the author once the limit is full.

To review usage, go to **Settings > Subscription**, where the active VCS user count is shown. Download the full list as a CSV file with columns `vcs_type`, `user_id`, `user_name`, `display_name`, and `last_seen_at`.

## Configure Workspace License

Go to **Settings > Subscription**, paste your license and click **Upload License**.

<img src="https://mintcdn.com/dbx/xlO-sjQEQuHdXd-M/content/docs/administration/license/bb-subscription.webp?fit=max&auto=format&n=xlO-sjQEQuHdXd-M&q=85&s=f70d9628063c931f3434fb03b2843886" alt="subscription" width="1812" height="1242" data-path="content/docs/administration/license/bb-subscription.webp" />

## Configure Instance License

Some features (e.g. [Dynamic Data Masking](/security/data-masking/overview)) require assigning license quota to individual instances. Enterprise-wide features like [SSO](/administration/sso/overview/) work without per-instance assignment.

<img src="https://mintcdn.com/dbx/xlO-sjQEQuHdXd-M/content/docs/administration/license/instance-license.webp?fit=max&auto=format&n=xlO-sjQEQuHdXd-M&q=85&s=43488f747265f46028df365bf126f254" alt="How instance license works" width="553" height="553" data-path="content/docs/administration/license/instance-license.webp" />

You can assign instance licenses from:

1. **The instance page** — assign/unassign directly on each instance.

   <img src="https://mintcdn.com/dbx/xlO-sjQEQuHdXd-M/content/docs/administration/license/bb-instance-assign.webp?fit=max&auto=format&n=xlO-sjQEQuHdXd-M&q=85&s=7a5246854c8b1a0a19f3d10ad1883241" alt="Assign license on instance page" width="2762" height="1092" data-path="content/docs/administration/license/bb-instance-assign.webp" />

2. **Settings > Subscription** — click the instance area or edit icon to open the license drawer, tick the instances, and click **Confirm**.

   <img src="https://mintcdn.com/dbx/xlO-sjQEQuHdXd-M/content/docs/administration/license/bb-edit-assign.webp?fit=max&auto=format&n=xlO-sjQEQuHdXd-M&q=85&s=3417c0601761b6108cfe57fd712fec52" alt="Open license drawer from subscription page" width="2002" height="1192" data-path="content/docs/administration/license/bb-edit-assign.webp" />

   <img src="https://mintcdn.com/dbx/xlO-sjQEQuHdXd-M/content/docs/administration/license/bb-assign-licenses.webp?fit=max&auto=format&n=xlO-sjQEQuHdXd-M&q=85&s=d2c96a042e6ca2a83b093b2238a3462f" alt="Select instances and confirm" width="2000" height="1234" data-path="content/docs/administration/license/bb-assign-licenses.webp" />

3. **Gated feature prompts** — when you encounter a feature requiring a license, click the **Assign License** button in the popup.

   <img src="https://mintcdn.com/dbx/xlO-sjQEQuHdXd-M/content/docs/administration/license/bb-database-license.webp?fit=max&auto=format&n=xlO-sjQEQuHdXd-M&q=85&s=24930ae0f08a4fca5502da37ff1ef33a" alt="License prompt on database page" width="2762" height="1628" data-path="content/docs/administration/license/bb-database-license.webp" />

   <img src="https://mintcdn.com/dbx/xlO-sjQEQuHdXd-M/content/docs/administration/license/bb-license-data-masking.webp?fit=max&auto=format&n=xlO-sjQEQuHdXd-M&q=85&s=8f591696c0b81b6e02ab891664abac75" alt="Assign license from data masking popup" width="2762" height="1638" data-path="content/docs/administration/license/bb-license-data-masking.webp" />

<Tip>
  To reduce costs, license only the instances that need advanced features (e.g., production only).
</Tip>