> For the complete documentation index, see [llms.txt](https://aibotkit-docs.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-docs.gitbook.io/documentation/plans-and-billing/add-ons.md).
# Add-ons & Message Top-ups
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.
There are **two kinds**, depending on your plan:
| Your plan | What you buy | How it works |
| -------------------------------- | ---------------------------- | -------------------------------------------------------------------- |
| **Free Full Access** | One-time **message top-ups** | A single purchase added straight to your balance. Buy again anytime. |
| **Basic / Essential / Business** | Recurring **add-ons** | Extra message credits or storage that renew with your subscription. |
{% hint style="info" %}
**Free plan users:** You don't need to upgrade to buy more messages — use the one-time [message top-ups](#free-plan-one-time-message-top-ups) below. Recurring add-ons (with proration and monthly renewal) are for paid plans only.
{% endhint %}
***
## Free Plan: One-Time Message Top-Ups
On the **Free Full Access** plan, your 100 messages are a one-time allowance that doesn't reset each month. When you run low, buy a **one-time top-up** — no subscription, and you can buy again whenever you need to.
| Top-up | Price |
| ---------------- | ------------------ |
| **50 messages** | **$9** (one-time) |
| **100 messages** | **$18** (one-time) |
The "Add messages" dialog on the Plans & Billing page
**How to buy a top-up:**
1. Go to **Settings → Plans & Billing** in your dashboard.
2. In the **Current Plan** box, click **Add messages**.
3. Use **+ / −** to choose **50 ($9)** or **100 ($18)** messages.
4. Click **Buy … messages** → you'll go to secure **Stripe Checkout**.
5. *(Optional)* Enter a **coupon code** in the **Add promotion code** field to apply a discount.
6. Pay, and your messages are credited automatically when you return to the dashboard.
{% hint style="success" %}
**Coupon codes work on top-ups.** Add your code in the **Add promotion code** box on the Stripe Checkout page before paying.
{% endhint %}
For full details of the free plan, see [Free Full Access Plan](/documentation/plans-and-billing/free-full-access-plan.md).
***
## Recurring Add-ons (Paid Plans)
On **Basic**, **Essential**, and **Business** plans, add-ons are optional recurring extras that boost your plan limits and renew with your subscription:
| 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 **Settings**, then open the **Plans & Billing** tab.
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**
* Recurring add-ons are only available on paid plans. On the **Free Full Access** plan, use the one-time **Add messages** top-up in your Current Plan box instead (see [above](#free-plan-one-time-message-top-ups)).
**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-docs.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.