> For the complete documentation index, see [llms.txt](https://help.rankability.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.rankability.com/account-and-settings/understanding-billing-and-credits.md).

# Understanding billing and usage

Understand plan allowances for tracked prompts, workspaces, and AI platforms, protected legacy plans, pooled usage, recovery windows, and subscription changes.

Rankability's paid plans are Starter, Core, and Team. Each one includes every Rankability tool and unlimited users. What differs between them is how many prompts you can actively track, how many brand workspaces you can keep, and which AI platforms you can track.

Open **Billing** from the Settings group to see your plan, allowances, enabled AI platforms, invoices, and pooled usage. Billing has its own `/billing` page; the older `/usage` route redirects there.

## What your plan includes

| Plan    | Active tracked prompts | Brand workspaces | AI platforms                            |
| ------- | ---------------------- | ---------------- | --------------------------------------- |
| Starter | 60                     | 1                | ChatGPT, Google AI Mode, and Claude     |
| Core    | 125                    | 3                | adds Google AI Overviews and Perplexity |
| Team    | 250                    | 10               | adds Gemini, Grok, and Copilot          |

Every plan also includes Google Search, local, and video tracking, your choice of daily, weekly, or monthly monitoring for each tracked prompt, scheduled tracking, and Agent API and MCP access.

Agency is no longer sold. Existing Agency subscriptions keep the allowances and terms they were bought with, and subscriptions bought under earlier Starter, Core, or Team packaging keep theirs — a plan name alone does not tell you which allowances apply.

Billing shows the exact allowances, enabled-platform count, and full platform list for your own subscription, including any paid platform add-ons. Read it there rather than inferring coverage from this table or a plan name. For what each surface measures, see [Supported tracking platforms](/track/supported-tracking-platforms.md).

Tracked prompts are counted as an active total, not a lifetime one. Billing shows the current figure against your limit, and Tracker shows where a new report would leave you before you start tracking it. Pausing or removing a report returns its allowance.

## Add an AI platform without changing plan

A current subscription can add any AI platform its base plan does not already include. Billing shows every supported platform, marking each one **Enabled** or **Available to add**:

1. Open **Billing** and find **AI platforms**.
2. Select **Add platforms** or choose a tile labeled **Available to add**.
3. Choose the platform. Billing shows the add-on price for your monthly or yearly billing interval.
4. Review the proration and new recurring subscription total, then confirm the change.

Each selected platform adds one paid platform unit to the same subscription. Access is enabled after the required payment succeeds. If Stripe needs another payment step, Rankability opens the hosted invoice and keeps access pending until it is resolved. A subscription that is still trialing can add a platform without an immediate charge; the add-on becomes part of the recurring subscription.

To remove a paid platform add-on, select its enabled tile in Billing and confirm the removal. A platform included with the base plan cannot be removed individually. Changing plan or billing interval preserves paid platform add-ons unless the new base plan already includes one of them.

## Protected legacy plans

Subscriptions bought before the current packaging keep the price and the client or workspace terms they were sold, and can track every supported AI platform. Billing marks these with a **Grandfathered** badge and shows that the existing price is protected. Rankability does not convert a protected subscription to current plan terms automatically.

Do not start a new checkout to correct protected terms. Contact support with the organization and invoice details instead.

## Pooled usage instead of credits

Paid accounts do not manage a credit wallet or action-by-action prices. On-demand activity is pooled across the organization and shown as remaining percentages for rolling 24-hour and 7-day windows. Rankability keeps this indicator out of the way while usage is healthy.

If an on-demand window reaches its limit, new on-demand work pauses with a recovery time. Older activity continuously rolls out of the window, so capacity returns automatically. Work already saved remains available.

## Scheduled work is protected

Routine scheduled tracking and monitoring are recorded separately from on-demand work and are not blocked by the on-demand windows. Provider quotas, request-rate controls, concurrency safeguards, and abuse protections can still apply independently.

## API and MCP

The Agent API and hosted MCP connection use the same plan entitlement and pooled usage as the web application. `GET /api/agent/v1/usage` and `get_usage_and_limits` return percentage windows and recovery times rather than credit prices. Copywriter Core remains a separate product with completed-outcome allowances.

## Change or cancel a subscription

* Choose a plan card and monthly or yearly interval directly in Billing. Review the in-app confirmation before Rankability updates the existing Stripe subscription; active customers are not sent through first-purchase checkout to create another subscription.
* **Invoices** opens Stripe billing management for receipts and payment details, then returns full-platform customers to Billing.
* Use the cancellation controls in Billing to stop renewal. Access continues through the paid period shown there, and a **Resume subscription** control appears while a cancellation is scheduled.

The Billing confirmation and any Stripe-hosted payment page are authoritative for a new charge, proration, or recurring total. Review them before confirming, especially when leaving protected legacy terms.

## Troubleshooting

* **You cannot add another brand workspace** — Check the workspace allowance for your plan in Billing. Protected subscriptions use their existing terms instead of a plan cap.
* **You cannot track another prompt** — You are at your active tracked prompt allowance. Pause or remove a report you no longer need, or change plan.
* **An AI platform is unavailable in setup** — Open Billing. The platform may be available as a paid add-on, or you can compare a plan that includes it. A platform remains unavailable until any required add-on payment succeeds.
* **A newly added platform is still unavailable** — Finish the hosted invoice or payment action if one was shown, then return to Billing. Access is not granted from a failed or incomplete payment.
* **A removed platform still looks enabled** — Refresh Billing once. The add-on list from Billing is authoritative; contact support if the removed platform remains after Stripe finishes the change.
* **On-demand work is paused** — Open Billing to see which rolling window reached its limit and when capacity begins returning.
* **Scheduled work did not run** — Check the project schedule, connection health, and provider or queue status; scheduled work does not consume the on-demand window.
* **Your legacy terms look different** — Do not start a new checkout. Existing subscriptions are protected; contact support with the organization and invoice details.
* **The Stripe total is unexpected** — Do not confirm the change. Compare the plan and interval you selected against the summary, then contact support.

## Related articles

* [Control your usage](/account-and-settings/control-your-usage.md)
* [Setting up keyword tracking](/track/setting-up-keyword-tracking.md)
* [Supported tracking platforms](/track/supported-tracking-platforms.md)
* [Connecting Rankability to AI assistants with MCP](/api/mcp-getting-started.md)
* [Troubleshooting common issues](/troubleshooting/troubleshooting-common-issues.md)