> For the complete documentation index, see [llms.txt](https://docs.brigge.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.brigge.ai/documentation/account-and-plans/brigge-subscriptions-and-tokens.md). # Brigge subscriptions & tokens ## Introduction Brigge runs on a token-based system. When you [register for a Brigge account](/documentation/account-and-plans/brigge-registration.md), you receive 1,000 tokens to get started, with full access to the platform. When you're ready to go further, you can move to a [paid subscription](#how-do-subscription-allowances-work) - monthly and annual plans are available to suit different business sizes. If you need flexibility beyond your plan's allowance, you can add an [overage plan](#how-do-overages-work). This provides additional tokens that can be used as a buffer if your subscription allowance is exceeded. ## How do subscription allowances work? When you purchase a subscription plan, you receive a monthly token allowance. Subscription plans run on calendar months. If you subscribe part-way through a month, your payment amount and token allowance are pro-rated accordingly. {% hint style="info" %} Unused tokens do not roll over; token allowances reset with each billing cycle. {% endhint %}

Adding a payment method

From the navigation menu, select `settings` ➥ `billing management` ➥ `billing information`, then follow on-screen instructions to add a new payment method:

Viewing your subscription plan details

From the navigation menu, select `settings` ➥ `billing management` ➥ `subscription`. Here, you'll find current subscription, overage, and token balance information. For example:

Purchasing a subscription plan

[Go to subscription plan details](#viewing-your-subscription-plan-details) for your account, then select the `manage plan` option from the current subscription plan panel. For example:

From here, you can view available plans and purchase a subscription. {% hint style="info" %} To purchase any subscription plan, you will be asked to select an existing payment method. You can add payment methods from [billing information](#adding-a-payment-method). {% endhint %}

Cancelling your subscription plan

{% hint style="danger" %} When a plan is cancelled, remaining tokens can be used until the next billing date. After this time, deployed pipelines will stop running, and cannot be initiated manually or via the Brigge API. {% endhint %} [Go to subscription plan details](#viewing-your-subscription-plan-details) for your account, then select the `cancel plan` option in the `current subscription plan` panel. For example:

{% hint style="info" %} If you have added [overages](#how-does-overage-work) for your plan, remember to cancel this too. Overages are billed independently and, if used, will continue until cancelled. {% endhint %}

Viewing your subscription invoices

From the navigation menu, select `settings` ➥ `billing management` ➥ `invoices`:

## Token usage Tokens are consumed by the following actions:

Action	Notes
Pipeline runs	The more complex a pipeline or the larger its payloads (so processing takes longer), the more tokens are used.
AI usage	An AI operation (e.g. Ask Briggette; generate mapping; generate script) consumes one token.

Token usage information is available in various places throughout Brigge, as summarised below.

Token usage detail view (subscription page)

To view your token balance, subscription plan, and overage settings, select `settings` ➥ `billing management` ➥ `subscription` from the navigation menu. Here, you'll find current subscription, overage, and token balance information. For example:

Token usage summary (dashboard)

You can see your token usage at a glance, from [your dashboard](#user-content-fn-1)[^1]. For example:

{% hint style="info" %} For more information, see [Dashboard](/documentation/brigge-for-operators/dashboard.md) documentation. {% endhint %}

Token usage per pipeline run (history)

When viewing pipeline run history from [your history page](#user-content-fn-2)[^2], each run includes a token count. For example:

{% hint style="info" %} For more information, see [History](/documentation/brigge-for-operators/history-and-retries.md) documentation. {% endhint %}

Token usage per activity (activity logs)

You can filter [your activity logs](#user-content-fn-3)[^3] to view any activities that have consumed tokens. For example:

## How does overage work? Activating *Overage* ensures that your pipelines keep running if your regular subscription allowance is exceeded. Additional tokens are used when required, on a pay-as-you-go basis. {% hint style="info" %} Overage use is calculated and billed on the [4th of each month](#key-dates-and-timings). The calculation is based on the number of tokens used above the allowance provided by your subscription plan. {% endhint %} {% hint style="info" %} In the event that your account drops into overage but your subscription plan is upgraded before the next billing date, overage is not charged. Instead, any tokens used that *would* have been charged as overage are deducted from your upgraded allowance. {% endhint %} When you activate *Overage*, you are prompted to [set a limit](#setting-an-overage-limit) for the number of overage tokens that can be used each month (so you stay in control of spend) OR you can [choose not to apply a limit](#setting-an-overage-limit).

Enabling overages for your account

[Access subscription plan details](#viewing-your-subscription-plan-details) for your account, then select the `activate overage` option:

The *Change Subscription Plan* page is displayed, and you can purchase the *Overage* plan. Once you complete your purchase, the [set a limit](#setting-an-overage-limit) dialog is displayed, so you can decide how many overage tokens can be used each month. {% hint style="info" %} To purchase any subscription plan, you will be asked to select an existing payment method. You can add payment methods from [billing information](#adding-a-payment-method). {% endhint %}

Setting an overage limit

To limit the number of overage tokens that can be used each month, or to allow an unlimited number, [access subscription plan details](#viewing-your-subscription-plan-details) for your account, move down to the `token usage` panel and select the `manage limit` option:

Here, you can specify the `token limit` allowed, or choose `unlimited`:

{% hint style="info" %} You must apply one of these settings for overage tokens to be used. {% endhint %}

Cancelling overage

{% hint style="danger" %} Without overage tokens, pipelines will not run if your standard subscription plan allowance is exceeded. {% endhint %} [Access subscription plan details](#viewing-your-subscription-plan-details) for your account, then select the `cancel plan` option in the `overage buffer` panel. For example:

Having confirmed this action, overage tokens will stop immediately and your final invoice is issued on the next billing date.

## What happens if I run out of tokens? If your subscription allowance is reached and [overage](#how-does-overage-work) is *not* enabled for your account, pipelines will not run. This includes: * Pipelines initiated on automated triggers * Pipelines initiated manually * Pipelines initiated via the Brigge API ## Key dates & timings

Type	When billed	New tokens available	Notes
Initial monthly/annual subscription purchase	At the time of purchase	Upon purchase completion	If you purchase part way through a month, the number of tokens is pro-rated to the end of that month
Monthly subscription billing	Last day of the month	First day of the month	New tokens replace any existing token balance; remaining tokens are not rolled over
Annual subscription billing	Last day of the last month of the year	First day of the month	New tokens replace any existing token balance; remaining tokens are not rolled over
Overage billing	4th of the month	N/A	Billing is for overage tokens used in the previous month (pay-as-you-go model)

[^1]: **How do I get there?**\ Select *dashboard* from the main navigation menu: ![](https://2172380191-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8IqdqwZowcxtFpZfLa6k%2Fuploads%2FK9g4XlBig24G2Sd6u3PV%2Faccess%20dashboard%202.png?alt=media\&token=6ecf206b-27c8-482e-a6b1-989517e4291b)
[^2]: **How do I get there?**\ Select *History* from the main navigation menu: ![](https://2172380191-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8IqdqwZowcxtFpZfLa6k%2Fuploads%2Fuh8A0QL1MOo8oKHbGF4u%2Faccess%20history.png?alt=media\&token=631b1a3a-8fe1-4614-b2d5-697b6adb1398) [^3]: **How do I get there?**\ Select *Settings* ➥ *Activity logs* from the main navigation menu: