> For the complete documentation index, see [llms.txt](https://docs.humblytics.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.humblytics.com/understanding-your-data/plan-limits-and-upgrades.md).

# Plan Limits & Upgrades

Humblytics enforces plan limits on premium features — heatmaps, funnels, active A/B tests, websites, and team seats. When you reach a limit, the app shows your current usage, explains what is blocked, and gives you a clear path to upgrade instead of silently disabling buttons or surfacing raw errors.

***

## How limit checking works

Every plan-limited surface in the dashboard reads from the same usage data. You will see consistent counts and upgrade prompts whether you are on Heatmaps, Funnels, Experiments, the sites dashboard, or workspace team settings.

### Usage meters

When you have at least one item in use (for example, one heatmap page or one active test), a **usage meter** appears in the page header:

* **Label** — what is being counted (e.g. "Heatmaps used", "Active tests", "Funnels used")
* **Count** — current usage vs. your plan limit (e.g. `1 / 1`)
* **Remaining** — how many slots you have left, or `0 left` when at the limit
* **Segmented bar** — a visual fill showing used vs. available slots

During a **14-day free trial** of Business or Scale, usage meters may show your real counts but limits are not enforced. You can create freely until the trial ends or you upgrade.

On **Scale** and **Enterprise** plans, meters for unlimited features are hidden (heatmaps may show a compact label like `3 pages` when you have existing usage).

### Limit banners

When you are at a plan limit, an amber **plan limit** banner appears below the page header:

* A **PLAN LIMIT** label and a chip with your plan name (e.g. Business, Plus (Legacy))
* A title that names what is full (e.g. "You've used all funnels on the Business plan")
* Short guidance — delete an existing item, stop or archive a test, or upgrade
* An **Upgrade** button for account owners (team members see "ask your account owner" copy instead)

Plan-limit banners are dismissible. They reappear if you remain at the limit after dismissing.

When your **subscription has ended** after a cancel (or another terminal billing status), a separate **read-only** banner appears instead: it does **not** use the plan-limit styling. It explains that your subscription has ended, that existing items stay available to **view**, and that **Upgrade** restores creation. The same read-only rules apply even if your account still shows a paid plan name from your last subscription.

### Create buttons at the limit

Buttons that create new items — **Add Page**, **New Funnel**, **New Experiment**, **Add Site** — change behavior when you are at the limit:

| State               | Button behavior                                                 |
| ------------------- | --------------------------------------------------------------- |
| **Under the limit** | Normal create action (opens the add flow or wizard)             |
| **At the limit**    | Button label changes to **Upgrade →** and opens the plan picker |

This replaces the old behavior where buttons could appear clickable but do nothing, or stay disabled with no explanation.

***

## Limits by feature

Limits depend on your plan tier. Counts below are per account unless noted.

| Feature              | Plus (legacy, not sold) | Business ($79/mo) | Scale ($279/mo)                    |
| -------------------- | ----------------------- | ----------------- | ---------------------------------- |
| **Heatmap pages**    | 1 per property          | 5 per property    | Unlimited                          |
| **Saved funnels**    | 1 per property          | 5 per property    | Unlimited                          |
| **Active A/B tests** | 1 (account-wide)        | 5 (account-wide)  | Unlimited                          |
| **Websites**         | 5 (account-wide)        | Unlimited         | Unlimited                          |
| **Team seats**       | Not included            | Not included      | 5 included (+$9/mo per extra seat) |

{% hint style="info" %}
**Property vs. account scope.** Heatmap pages and saved funnels are counted **per property** (per website). Active A/B tests, websites, and team seats are counted **account-wide** across all properties under the same subscription.
{% endhint %}

**Plus Legacy** ($9 grandfathered) keeps 1 heatmap page, 1 saved funnel, 1 active test and 5 sites, with API access. It has no IP filtering, session recording or team seats. See [Frequently Asked Questions](https://docs.humblytics.com/frequently-asked-questions.md) for full plan details.

***

## Data points on the Free start and Agents plan

The Free start and the Agents plan are priced by data points, not by a monthly event limit. A data point is one tracked event: a pageview, click, form submission, custom event or revenue event. Reads, questions and tool calls are not counted.

| Plan                                          | Data points              | Sites     |
| --------------------------------------------- | ------------------------ | --------- |
| **Free start** ($0, no card)                  | The first 5,000          | 1         |
| **Agents** ($39 one time, not a subscription) | 100,000, valid 12 months | Unlimited |
| **Top-up**                                    | $29 per 100,000          |           |

What happens when you run out depends on the plan:

* **Free start** pauses tracking the moment the allowance is used. There is no card to charge, so there is no grace period.
* **Agents** emails you at 75% usage and gives a 3-day grace period before tracking stops.

Either way your collected data stays, and your agent can still read it. See [Set up with your AI agent](https://docs.humblytics.com/how-to-get-started/set-up-with-your-ai-agent.md).

***

## Sidebar, meter and billing by plan

Every plan uses the same sidebar layout. What changes is the navigation, the usage meter and the billing section, which depend on whether your plan is priced by data points (Free start, Agents) or is a team plan (Business, Scale, Enterprise). Nothing is locked behind a redirect: every page opens by its link on every plan. On Free start and Agents, the dashboard pages show a **Dashboards come with Business** upgrade card instead of data; your agent can still read everything through the API and MCP.

|                 | Free start and Agents plan                                                                    | Business, Scale, Enterprise                                                                                                  |
| --------------- | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **Sidebar**     | Home, Dashboard (with a **Business** badge), Agent & data, Account (**Usage & billing**)      | Home, Observe (Analytics, Heatmaps, Funnels, Attribution), Optimize (Experiments), Agent & data (Agents, Connectors, Export) |
| **Usage meter** | Data points over the last 12 months, with a **Top up · $29 per 100K** link on the Agents plan | Your plan's usage meter                                                                                                      |
| **Billing**     | Agents checkout and top-ups in **Account settings → Usage & billing**                         | Plan card on Home and billing in **Account settings**                                                                        |

* **Top up** opens **Account → Usage & billing**. It never charges you in one click.
* Inside a workspace owned by an account on a team plan, you see the team-plan sidebar, even if your own plan is Free start or Agents.
* While a checkout is finishing, the team-plan sidebar shows and plan numbers stay hidden until your plan updates.
* If plan information cannot load, the team-plan sidebar shows and plan numbers stay hidden.

### Agents page

**Agent & data → Agents** is the same page on every plan. It lists your connected agents (your account API keys) and when each was last used. The page has no plan card, data points or top-ups. **Workspace settings → Sites** moves sites between workspaces; deleting a site is in **Site settings → Danger zone**, and only the site owner can do it.

On the Free start or Agents plan with no site yet, **Finish in your agent** appears on Home and on the Agents page. It points you to your agent to add your first site.

{% hint style="info" %}
If an Agents account's subscription status is canceled, your existing sites stay available to view and adding new sites is blocked. Nothing is deleted.
{% endhint %}

***

## Where limits appear

### Heatmaps

* **Add Page** becomes **Upgrade** when your heatmap page limit is reached.
* A limit banner suggests deleting an existing page or upgrading.
* See [Understanding Heatmaps](https://docs.humblytics.com/understanding-your-data/understanding-heatmap.md).

### Funnels

* **New Funnel** becomes **Upgrade** when your saved-funnel limit is reached.
* Saving a brand-new funnel is blocked at the limit; editing an existing funnel is always allowed.
* AI funnel suggestions and the "new funnel" action route to the plan picker when at the limit.
* See [Understanding Funnels](https://docs.humblytics.com/understanding-your-data/understanding-funnels.md).

### Experiments (A/B tests)

* **New Experiment** becomes **Upgrade** when your active-test limit is reached.
* Only **active** tests count toward the limit — drafts, paused, completed, and archived tests do not.
* The experiment creation wizard also checks the limit on entry (for bookmarks and deep links).
* The experiment backlog's create actions respect the same limit.
* See [Understanding Experiments](https://docs.humblytics.com/understanding-your-data/understanding-experiments.md).

### Sites dashboard

* **Add Site** on the hub and in workspace settings becomes **Upgrade** when your website limit is reached.
* The dashed "Add site" card on the usage chart routes to the plan picker instead of the add-site wizard.
* See [Understanding Your Sites Dashboard](https://docs.humblytics.com/understanding-your-data/understanding-your-sites-dashboard.md).

### Team seats (Scale plan)

* Workspace **Team** settings show a seat usage meter and limit banner when all seats are in use.
* The invite flow is blocked at the limit with an explanation.
* Extra seats are available as a $9/month add-on on Scale and Enterprise.

***

## Agents plan: data points and top-ups

Accounts that sign up agent-first use **data points** instead of the per-feature limits above. A new agent sign-up starts on **Free start** with **5,000 free data points** and 1 site. The **Agents plan** is a one-time **$39** payment for **100,000** data points, valid 12 months, with unlimited sites (not a subscription).

When the balance needs attention, Home and the sidebar meter tell you:

| Balance status                        | What you see                                                                           |
| ------------------------------------- | -------------------------------------------------------------------------------------- |
| **Running low**                       | How many data points are left, with a link to **Usage & billing**                      |
| **Used up, paused or payment failed** | "Tracking is paused, so new visits are not recorded. Your data and agent access stay." |

Buying is always done from **Account → Usage & billing**: the Agents checkout on Free start, and top-ups ($29 per 100,000 data points) on the Agents plan. The sidebar meter's **Top up · $29 per 100K** link opens the same page.

### How top-ups work

* A top-up is charged to the card saved at the $39 checkout. Tracking resumes right away and the added data points are valid for 12 months.
* Each click is sent once, so a double click does not charge you twice.
* If your bank needs to confirm the payment, no card is saved, or the card is declined, you see a message to update your card in **Account settings** and try again.
* Top-ups are only offered on the Agents plan.

### Auto top-up (Agents plan)

Turn on **Auto top-up** in **Usage & billing** and Humblytics buys one 100,000 block for you when usage reaches 90% of your limit, charged to the saved card.

* The cap is **3 blocks per calendar month** by default, adjustable from 1 to 20.
* If a charge is declined or needs your bank's approval, auto top-up pauses until you re-save the setting.

***

## Team members vs. account owners

Upgrade actions require billing access:

| Role                        | At a plan limit                                                       |
| --------------------------- | --------------------------------------------------------------------- |
| **Account owner**           | Sees an **Upgrade** button on limit banners                           |
| **Team member** (non-owner) | Sees "Ask your account owner to upgrade" instead of an Upgrade button |

Team members can still view usage meters and understand why creation is blocked, but only the subscription owner can change plans.

***

## After your subscription ends (read-only)

Canceling does **not** delete your work. When Humblytics marks your Stripe subscription as ended (`canceled`, `unpaid` with no active relationship, or similar terminal states), the dashboard becomes **read-only** at the plan tier you last paid for:

| You can still…                                                       | You cannot…                                               |
| -------------------------------------------------------------------- | --------------------------------------------------------- |
| View traffic, pages, devices, locations, channels, forms, and clicks | Create new heatmap pages, funnels, or experiments         |
| Open existing heatmaps, funnels, and experiment results              | Add websites or finalize new sites from the add-site flow |
| Read attribution and revenue data you already connected              | Invite team members (Scale)                               |
| Browse **Agents** and revoke existing keys                           | Create new API keys                                       |

**Upgrade** (or billing recovery when an invoice is open) is the path back to full access. The app does **not** downgrade you to a free tier just to lock you out of data you already paid to collect.

If you **cancel at period end** in the Stripe customer portal, your status stays active until the period lapses — limits and creation keep working until that date.

***

## Failed payments vs. cancel

| Situation                                         | What you see                                                                                        |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| **Past due** — Stripe is still retrying your card | Paid features stay available. **Upgrade** may open the **customer portal** to pay the open invoice. |
| **Unpaid** with an existing subscription          | Same recovery path when a subscription ID exists; pay the invoice to restore good standing.         |
| **Canceled** — subscription fully ended           | Read-only mode above; **Upgrade** opens the plan picker for a new subscription.                     |

***

## Trial behavior

During your **14-day free trial** of Business or Scale, plan limits on creation are **not enforced**. You have full access to the features included in your trial plan: the same limits that apply after the trial, but without the caps blocking new heatmaps, funnels, tests, or sites.

### Seeing your trial status

While you are in a trial, the **trial banner** shows how many days are left, and **Account settings → Billing** shows **Trial · N days left** next to your plan. This is true whether the trial is a Humblytics trial or one you started through Stripe Checkout, so the banner does not disappear once your subscription is created.

A trial started through Stripe Checkout already has a payment method on file and converts to a paid plan on its own when the trial ends. Its banner stays a quiet reminder rather than a countdown, and it does not offer a second payment link.

When you return from Stripe Checkout, it can take a short moment for your subscription to activate. During that time the dashboard waits instead of showing **Trial ended** or an upgrade prompt. If activation has not finished after a few minutes, the app shows your account's actual state. Refresh the page, or contact **<support@humblytics.com>** if the trial still does not appear.

After the trial ends (or if you upgrade mid-trial, which ends the trial immediately), normal plan limits apply. See [What happens if I upgrade during my free trial?](https://docs.humblytics.com/frequently-asked-questions.md) in the FAQ.

***

## What to do when you hit a limit

1. **Free up a slot** — delete a heatmap page, remove a saved funnel, stop or archive an active test, or remove a team member.
2. **Upgrade your plan**: click **Upgrade** on any limit banner or create button. New subscriptions and plan changes use the in-app plan picker (Business and Scale; legacy Plus is not offered). If you have an overdue invoice on an existing subscription, **Upgrade** may send you to the Stripe customer portal instead. Plan changes made in the app apply immediately with prorated billing; contact **<support@humblytics.com>** if you need a change timed to your renewal.
3. **Ask your account owner** — if you are a team member, contact the person who manages billing.

For monthly **event** limits on Business and Scale, and for data points on the Free start and Agents plan, see the FAQ section on data limits. Those are separate from the per-feature creation limits described here.

***

## Related docs

* [Frequently Asked Questions — Pricing & Plans](https://docs.humblytics.com/frequently-asked-questions.md)
* [Understanding Heatmaps](https://docs.humblytics.com/understanding-your-data/understanding-heatmap.md)
* [Understanding Funnels](https://docs.humblytics.com/understanding-your-data/understanding-funnels.md)
* [Understanding Experiments](https://docs.humblytics.com/understanding-your-data/understanding-experiments.md)
* [Understanding Your Sites Dashboard](https://docs.humblytics.com/understanding-your-data/understanding-your-sites-dashboard.md)
