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

# Billing & Plans

> Manage your subscription, billing details, and usage

BubblaV offers flexible pricing plans to scale with your business needs. You can manage your subscription, view invoices, and track usage directly from the dashboard.

## Subscription Plans

We offer three main tiers to suit different needs:

<CardGroup cols={2}>
  <Card title="Free" icon="seedling">
    Perfect for testing and personal projects.

    * **Price**: \$0/month
    * 1 Website
    * 50 pages (web + files + text)
    * 100 messages/month
    * 100 MCP API calls/month
    * 7 days retention
    * Built-in integrations
    * Human handoff (chatbot → human)
    * Email to visitors
  </Card>

  <Card title="Pro" icon="star">
    For growing businesses needing advanced features. **Start with a 14-day free trial.**

    * **Price**: \$49/month (\$39/month annually, save \$120/year)
    * Everything in Free
    * 5 Websites
    * 5,000 pages (web + files + text) per website
    * 5,000 messages/month
    * 5,000 MCP API calls/month
    * 1 year retention
    * Advanced data sources and reports
    * Live Chat Dashboard (real-time takeover)
    * Human handoff scenarios (AI intent-based routing)
    * Integrations (Zendesk, HubSpot, Attio) and Custom tools
    * Custom branding (remove "Powered by")
    * 3 team member seats
    * Weekly data sync
  </Card>

  <Card title="Turbo" icon="bolt">
    For high-volume power users.

    * **Price**: \$99/month (\$79/month annually, save \$240/year)
    * Everything in Pro
    * 20 Websites
    * 50,000 pages (web + files + text) per website
    * 15,000 messages/month
    * 15,000 MCP API calls/month
    * 2 years retention
    * 10 team member seats
    * Priority support
    * Daily data sync
  </Card>
</CardGroup>

## Managing Your Subscription

To access billing settings:

1. Click your **user avatar** in the top-right corner of the dashboard
2. Select **Subscription** from the menu

You can also go directly to [bubblav.com/dashboard/subscription](https://www.bubblav.com/dashboard/subscription).

### Upgrading Your Plan

1. Navigate to the **Subscription** page (via user avatar menu or direct link).
2. Scroll down to the **Available Plans** section.
3. Click **Upgrade** on your desired plan.
4. Follow the checkout prompts to complete the purchase.

### Free Trial

<Note>
  The Pro plan includes a 14-day free trial for new customers. You get full access to all Pro features during the trial period.
</Note>

* **Eligibility**: Available to new customers who haven't had a paid subscription before
* **Card Required**: Your payment card is required at signup but won't be charged until the trial ends
* **Trial Duration**: 14 days from signup
* **Automatic Conversion**: After the trial, your subscription automatically converts to a paid Pro plan
* **Reminder**: We'll send you a reminder email 2 days before your trial ends
* **Cancel Anytime**: If you cancel during the trial, you won't be charged at all

To start a free trial, click **Start 14-Day Free Trial** on the Pro plan card in the Subscription page.

### Message Usage & Limits

Your plan includes a monthly allowance of AI responses (messages).

* **Reset Schedule**:
  * **Paid Plans**: Usage resets on your monthly billing date (e.g., if you subscribed on the 14th, it resets on the 14th of each month).
  * **Free Plan**: Usage resets on the 1st of every calendar month.
* **Tracking Usage**: The Subscription page shows a real-time progress bar of your message consumption.
* **Overages**: If you run out of messages, your chatbot will stop replying until the next cycle or until you purchase an add-on.
* **Add-on Packs**: You can buy "Extra Message Packs" (1,000 messages for \$5) that never expire and are used after your monthly allowance is exhausted.

### MCP API Call Quotas

MCP API calls are tracked separately from your AI message usage.

* **Free**: 100 MCP API calls/month
* **Pro**: 5,000 MCP API calls/month
* **Turbo**: 15,000 MCP API calls/month
* **Reset Schedule**: MCP API usage resets on a rolling 30-day window from your first MCP call in the current cycle.
* **Tracking Usage**: You can check current MCP API usage from your website settings in the dashboard.
* **When Limit Is Reached**: MCP requests return a rate limit error until the quota resets.

### Data Sync Frequency

BubblaV automatically syncs your data to keep your chatbot up-to-date. The frequency depends on your plan:

* **Free**: Every 30 days
* **Pro**: Every 7 days
* **Turbo**: Daily

This ensures your chatbot always has the latest information from your website and connected sources.

## Plan Features

### Free Plan Features

The Free plan includes essential features for testing:

* Basic AI chatbot functionality
* Built-in integrations (no external tools)
* Core analytics dashboard
* Message & conversation trends
* Export report data

### Pro Plan Features

The Pro plan unlocks advanced capabilities:

<AccordionGroup>
  <Accordion title="Smart Human Handoff">
    The AI automatically detects when it can't help and escalates to a human agent. It collects visitor information, creates a live support session, and generates external support tickets (Zendesk, HubSpot, etc.) for seamless follow-up.
  </Accordion>

  <Accordion title="Live Chat Dashboard">
    Take over conversations in real-time with the Live Chat Dashboard. Monitor active conversations, see what visitors are typing, and jump in instantly when needed. Provides full control to handle complex queries personally.
  </Accordion>

  <Accordion title="Advanced Reports">
    Access detailed analytics including:

    * Most active times
    * Conversation flow visualization
    * Visitor geography
    * Top unanswered questions
    * Bad feedback conversations
    * Most visited links
    * Leads captured
  </Accordion>

  <Accordion title="Integrations">
    Connect with external tools:

    * Zendesk (tickets and knowledge base)
    * HubSpot (CRM and tickets)
    * Attio (CRM)
    * Custom tools
    * MCP Servers (Model Context Protocol) - Connect to any external API or service
  </Accordion>

  <Accordion title="Custom Branding">
    Remove the "Powered by BubblaV" branding and fully customize the widget appearance to match your brand.
  </Accordion>
</AccordionGroup>

## Billing Providers

We support billing through different providers depending on how you signed up:

### Polar

For users who sign up directly on BubblaV (non-Shopify merchants).

* **14-day free trial** available on Pro plan for new customers
* Invoices emailed automatically
* Choose monthly or yearly billing (save 20% with annual)

### Shopify

For users who installed BubblaV via the Shopify App Store.

* Charges appear on Shopify bill
* Upgrades/downgrades via Shopify billing
* **Note**: Shopify billing only supports monthly billing cycles
* Usage tracking in BubblaV dashboard

## Cancellation

You can cancel your subscription at any time by downgrading to the Free plan:

1. Click your **user avatar** in the top-right corner and select **Subscription**, or go to [bubblav.com/dashboard/subscription](https://www.bubblav.com/dashboard/subscription)
2. Click **Downgrade to Free** on your current plan
3. Confirm the downgrade when prompted
4. Your plan will remain active until the end of the current billing period

<Note>
  **During Free Trial**: If you cancel during your 14-day free trial, you won't be charged at all and your account will revert to the Free plan immediately.
</Note>
