mintlify__docs/credits.mdx

---
title: "Credit pricing"
description: "Understand how Mintlify credits work for assistant messages, agent runs, and workflows. How credit tiers, overages, and rollovers are billed."
keywords: ["credits", "billing", "pricing", "AI chat", "messages", "tiers", "usage"]
---

Some Mintlify features consume credits.

* Assistant responses
* Agent runs in the editor or on Slack
* Workflow runs

For the most current pricing information, see the [Pricing page](https://mintlify.com/pricing) or view the [Usage](https://app.mintlify.com/settings/organization/usage) page in your dashboard.

## Pricing tiers

| Monthly credits | Monthly cost | Rollover cap |
|:----------------|:-------------|:-------------|
| 0 | $0 | 0 |
| 10,250 | $100 | 15,375 |
| 26,000 | $250 | 39,000 |
| 52,500 | $500 | 78,750 |
| 80,000 | $750 | 120,000 |
| 108,500 | $1,000 | 162,750 |
| 275,000 | $2,500 | 412,500 |
| 555,000 | $5,000 | 832,500 |
| 850,000 | $7,500 | 1,275,000 |
| 1,150,000 | $10,000 | 1,725,000 |

**Overages** are charged per additional credit at $0.01 rather than triggering an automatic tier upgrade. You can set usage alerts to receive an email when you reach a certain percentage of your tier limit. Allowing overages can be cheaper than moving up a tier depending on your usage patterns.

<Note>
  Overages are disabled by default. You must enable them on the [Usage](https://app.mintlify.com/settings/organization/usage) page of your dashboard.
</Note>

**Rollovers** carry forward up to 50% of unused credits to the next month, so the maximum credits available in any month is 1.5 times your monthly limit. Rollovers reset if you change tiers.

Higher tiers offer a lower effective cost per credit. If your usage consistently reaches the top of your current tier, upgrading is more economical than paying ongoing overage charges.

Upgrades and downgrades take effect immediately and are prorated for the current billing cycle.

For high-volume usage or custom credit packages, [contact sales](mailto:sales@mintlify.com). Custom credit packages are available on enterprise plans only.

## How credits work

Different features consume different amounts of credits per interaction:

| Feature | Average credits per interaction |
|:--------|:--------------------------------|
| Assistant response | 23 |
| Editor agent run | 115 |
| Slack agent run | 110 |

Workflows also consume credits when they run:

| Workflow | Average credits per run |
|:---------|:------------------------|
| Update from code changes | 180 |
| Update from assistant conversations | 212 |
| Broken link detection | 285 |
| Changelog | 223 |
| SEO audit | 422 |
| Translations | 913 |
| Typo check | 330 |
| Writing style | 235 |

## Estimating your usage

Use the averages in the [How credits work](#how-credits-work) section to estimate your monthly credit needs.

For example, if your docs site handles 500 assistant responses per month, that's roughly 11,500 credits (500 × 23). Adding a weekly broken link detection workflow adds about 1,140 credits per month (4 × 285).

After using credit-powered features for a month, review your usage patterns to see if you should adjust your tier.

## Cost optimization

**Schedule workflows instead of triggering on every push.** Workflows like SEO audits, writing style checks, and broken link detection don't need to run on every code change. Running these on a daily or weekly cron schedule rather than on every push significantly reduces credit consumption without meaningful impact on content quality.

**Monitor your usage patterns.** The [Usage](https://app.mintlify.com/settings/organization/usage) page in your dashboard shows a breakdown by feature category. If a particular workflow is consuming more credits than expected, review its trigger or any custom instructions.