> For the complete documentation index, see [llms.txt](https://aibotkit.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aibotkit.gitbook.io/documentation/plans-and-billing/add-ons.md).
# Add-ons
Add-ons let you increase your message credits or storage capacity without upgrading to a higher plan. If you're happy with your current plan but occasionally need more messages or storage, add-ons are the perfect solution.
{% hint style="info" %}
**Plan Requirement:** Add-ons are available on **paid plans only** (Basic, Essential, and Business). Free plan users must upgrade to a paid plan before purchasing add-ons.
{% endhint %}
***
## What Are Add-ons?
Add-ons are optional extras that boost your plan limits:
| Add-on | What It Gives You | Per Unit |
| -------------------------- | ---------------------------------------------------- | --------------------- |
| **Extra Message Credits** | Additional AI-generated messages per month | +1,000 messages |
| **Extra Storage Capacity** | Additional character storage for your knowledge base | +5 million characters |
You can purchase up to **10 units** of each add-on type.
### Example
You're on the **Essential Plan** (2,000 messages/month, 20M characters storage). During a busy month, you expect 3,500 messages. Instead of upgrading to Business, you purchase **2 units of Extra Message Credits** (+2,000 messages), giving you 4,000 total messages for that month.
***
## How to Purchase an Add-on
1. Log into your [AI Bot Kit dashboard](https://app.aibotkit.io).
2. In the left sidebar, go to **Plans & Billing**.
3. Scroll to the **Add-ons** section.
4. Choose the add-on you want:
* **Extra Message Credits** — select how many units (1–10).
* **Extra Storage Capacity** — select how many units (1–10).
5. Click **Purchase Add-on**.
6. Confirm the payment. The add-on is added to your existing subscription instantly.
***
## Pricing
Add-on prices are shown in your dashboard and depend on your billing interval:
| Add-on | Monthly Price | Yearly Price (per month) |
| ------------------------------------------ | ------------- | ------------------------ |
| Extra Message Credits (per 1,000 messages) | Varies | Varies |
| Extra Storage Capacity (per 5M characters) | Varies | Varies |
{% hint style="info" %}
If you pay yearly for your main plan, add-ons are also billed yearly at a discounted rate.
{% endhint %}
***
## How Billing Works
* **Same billing cycle** — Add-ons are added to your existing Stripe subscription. They renew on the same date as your main plan.
* **Prorated charges** — If you add an add-on mid-cycle, you only pay for the remaining days in your current billing period.
* **Prorated refunds** — If you cancel an add-on mid-cycle, a prorated credit is applied to your account.
***
## Managing Your Add-ons
### View Active Add-ons
In **Plans & Billing → Add-ons**, you'll see:
* Which add-ons are currently active
* How many units you have
* Your new total limits (plan limit + add-on bonus)
### Cancel an Add-on
1. Go to **Plans & Billing → Add-ons**.
2. Find the active add-on you want to remove.
3. Click **Cancel**.
4. Confirm the cancellation.
Your add-on stays active until the end of your current billing period, then stops renewing. A prorated credit is applied if you cancel mid-cycle.
***
## Tips for Using Add-ons
* **Use add-ons for temporary spikes.** If you only need extra capacity for a month or two, add-ons are cheaper than upgrading your plan.
* **Monitor your usage.** Check your message and storage usage regularly in the dashboard to decide if add-ons make sense.
* **Combine add-ons.** You can have both message and storage add-ons active at the same time.
* **Yearly is cheaper.** If you know you'll need extra capacity long-term, paying yearly saves money.
***
## Troubleshooting
**I don't see the Add-ons section**
* Add-ons are only available on paid plans. Upgrade to Basic, Essential, or Business first.
**My add-on purchase failed**
* Make sure your payment method on file is up to date.
* Try again in a few minutes. If it keeps failing, contact support.
**I canceled an add-on but my limits haven't changed**
* Canceled add-ons remain active until the end of your current billing period. Your limits will adjust on your next renewal date.
***
## Related Topics
* [Upgrading to Paid Plans](/documentation/plans-and-billing/upgrading-to-paid-plans.md) — Upgrade your main plan
* [Where to Find Your Usage](/documentation/plans-and-billing/where-to-find-your-usage.md) — Monitor messages and storage
* [Monthly vs Yearly Pricing](/documentation/plans-and-billing/monthly-vs-yearly-pricing.md) — Save with yearly billing
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://aibotkit.gitbook.io/documentation/plans-and-billing/add-ons.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.