> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iblueprint.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Plans and Billing — iBlueprint Subscription Tiers

> Compare iBlueprint's Free and Premium plans, understand resource limits, learn how to upgrade, and find out what happens when you reach a limit.

iBlueprint offers two subscription tiers — Free and Premium — designed to scale with your team's needs. Each plan defines a set of resource limits that govern how many blueprints, chatbots, organizations, team members, and tokens you can use within a billing period. Understanding these limits helps you choose the right plan and avoid unexpected blocks when building.

## Available plans

<CardGroup cols={2}>
  <Card title="Free" icon="circle">
    Get started with iBlueprint at no cost. Ideal for individuals exploring the platform or building small, personal projects.
  </Card>

  <Card title="Premium" icon="star">
    Full access to team features, higher limits, and organization management. Built for teams that need to collaborate and scale.
  </Card>
</CardGroup>

## Plan limits

The table below shows the key limits for each plan. Limits marked with `—` are not available on that plan.

| Resource             | Free      | Premium      |
| -------------------- | --------- | ------------ |
| Private blueprints   | 1         | Higher limit |
| Chatbots             | 1         | Higher limit |
| Organizations        | 1         | Higher limit |
| Organization members | 1         | Higher limit |
| Tokens per month     | 5,000,000 | Higher limit |
| Public prompts       | Unlimited | Unlimited    |
| Create organizations | —         | ✓            |
| Invite members       | —         | ✓            |

<Note>
  Exact numbers for Premium limits depend on your specific plan configuration. Contact your account manager or check **Settings → Billing** for the limits applied to your subscription.
</Note>

## Billing periods

Premium plans are available on monthly or yearly billing cycles. Yearly billing typically offers a lower effective monthly rate. You choose a billing period when you upgrade and can change it at renewal time.

The API tracks your billing period via `billing_period` on your subscription, which is either `monthly` or `yearly`.

## How to upgrade

<Steps>
  <Step title="Open Billing settings">
    Click your avatar in the top-right corner, select **Settings**, then choose **Billing** from the left sidebar.
  </Step>

  <Step title="Select a plan">
    Click **Upgrade** next to the Premium plan. Review the plan features and choose your billing period (monthly or yearly).
  </Step>

  <Step title="Enter payment details">
    Complete checkout via Stripe. Your new limits take effect immediately once the payment is confirmed.
  </Step>
</Steps>

## What happens when you reach a limit

iBlueprint enforces resource limits at the point of creation. When you attempt to create a resource that would exceed your plan's limit — for example, a second private blueprint on the Free plan — the platform blocks the action and returns an error explaining which limit was reached.

This applies to:

* **Blueprints** — enforced when creating a new private blueprint
* **Chatbots** — enforced when creating a new chatbot
* **Organization members** — enforced when accepting a team member invite
* **Tokens** — enforced per monthly period; execution is blocked when your monthly token budget is exhausted

<Warning>
  Tokens do not roll over between billing periods. Your monthly token count resets at the start of each billing period.
</Warning>

If you hit a limit mid-workflow, upgrade your plan or contact support to discuss add-ons.

## Managing your subscription

To view your current usage, cancel, or change your plan, go to **Settings → Billing**. Active subscriptions show the current period's start and end dates, your billing period, and a breakdown of resource usage against your plan limits.

Subscription statuses you may see:

| Status         | Meaning                                                     |
| -------------- | ----------------------------------------------------------- |
| `active`       | Your subscription is current and all features are available |
| `trialing`     | You are in a trial period                                   |
| `past_due`     | Payment failed; a retry is pending                          |
| `grace_period` | Payment failed; access continues temporarily                |
| `canceled`     | Subscription has been canceled; access ends at period end   |