Skip to content

docs: clarify MT credits, billing limits, and self-hosted link in sub… #1109

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bdshadow merged 2 commits into from
May 22, 2026
Merged

docs: clarify MT credits, billing limits, and self-hosted link in sub… #1109

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
83cf011
docs: clarify MT credits, billing limits, and self-hosted link in sub…
Barush May 15, 2026
52e7dbc
Update organization_settings.mdx
Barush May 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion platform/projects_and_organizations/machine_translation_settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ image: /img/og-images/platform.png
import { ScreenshotWrapper } from "../shared/_ScreenshotWrapper";

Machine translation (MT) uses external providers like AI providers, Google or DeepL for automated localization of the base text to currently edited language.
Number of machine translations that you can use is limited by credits which are shown in language settings. You can **buy more credits** in the [billing settings](organization_settings#view-and-manage-subscriptions).
Each plan includes a monthly MT credit allowance, which you can monitor in your [billing settings](organization_settings#view-and-manage-subscriptions). On pay-as-you-go plans (which are all cloud self-served plans), translations continue uninterrupted if you exceed your allowance. The extra usage is billed with your next invoice according to the [current pricing](https://tolgee.io/pricing).

## Supported Machine Translation Providers
Currently, we support the following machine translation providers:
Expand Down
23 changes: 9 additions & 14 deletions platform/projects_and_organizations/organization_settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,31 +38,26 @@ You can also set the permissions granularly. The **granular permissions are a pa

## View and Manage Subscriptions

This page shows your **organization's subscription information**, including the current plan and usage.
This page shows your **organization's subscription information**, including the current plan and usage. You can also **change your plan** here.

You can also **change your plan** to a different one here.
Plans differ based on the chosen hosting option- you can choose between Tolgee Cloud or self hosted. To switch between them click the toggle in the centre.
Tolgee is available as [Tolgee Cloud](https://app.tolgee.io/login) (the default, fully managed option) or as a [self-hosted](/platform/self_hosting/getting_started) installation.

<ScreenshotWrapper
src="/img/docs/platform/subscriptions.webp"
alt="Tolgee subscriptions"
/>

The usage shown on this page is the **total usage of all projects in your organization**. The information regarding usage covers the following:
The usage shown on this page is the **total usage of all projects in your organization**, covering:

- **Used keys** – The total number of keys used in your organization, regardless of how many langauages they are translated to.
- **Used seats** - The total number of users who are a part of your organization or any project owned by the organization.
- **Used MT credits** – The number of Machine Translation credits that have been used in your organization since the last refill.
- **Used keys** – The total number of keys used in your organization, regardless of how many languages they are translated to.
- **Used seats** – The total number of users who are part of your organization or any project owned by it.
- **Used MT credits** – The number of Machine Translation credits used since the last monthly refill.
- **Next credits refill** – The date when your MT credits will be refilled.

:::info
A **key** is a unique identifier for a translatable text. Each distinct key in your project (regardless of how many languages it covers) counts towards your usage.
Each user, regardless of the role, occupies one seat.
:::
### What happens when you reach a limit?

:::tip
More information about the plans can be found on the [Pricing](https://tolgee.io/pricing) page.
:::
- **Free plan** – Limits are enforced per resource: you cannot add new users when the seat limit is reached, cannot add new keys when the key limit is reached, and cannot use machine translation when MT credits are exhausted. Everything else continues to work. Upgrade your plan to lift these limits.
- **Paid plans** – All self-served paid plans are pay-as-you-go. If you exceed your plan's included allowance, the additional usage continues uninterrupted and is invoiced at the end of the month according to the [current pricing](https://tolgee.io/pricing).

## Access Invoices and Billing History

Expand Down
Loading