Skip to content
Docs

Per-client credit budgets

A RankX AI client budget is a monthly ceiling on the agency's one credit wallet. Every client starts uncapped, and a budget of zero stops its spend.

A per-client credit budget is a monthly ceiling on your agency's one shared credit wallet. It is not a sub-wallet: no credits are moved, set aside or reserved for that client. A budget says "this client's Websites may use at most this many credits this month".

That is why the agency wallet can be full while one client is stopped at its ceiling. Set budgets in Agency Admin, on the client's Credits tab.

How does a ceiling differ from a separate pot?

What a per-client budget is
graph TD
  W[One agency wallet] --> S{A client's Website spends}
  S --> C{Has this client reached its ceiling?}
  C -->|No| A[Allowed, drawn from the shared wallet]
  C -->|Yes| R[Refused for this client, wallet untouched]
  W --> O[The agency's own work: never capped by a client budget]

Three things follow from the ceiling model:

Topping up the wallet does not restart a capped client. The wallet was never the limit. Raising that client's allocation is.

An unused allocation reserves nothing. A client with a large allocation that spends nothing is not holding credits back from anyone else.

Allocations can add up to more than the wallet. Each one limits one client, so the total is not a share of anything. The wallet balance is what covers everyone spending at once.

What are the three settings?

SettingMeaning
No allocationUncapped. The default, and where every client starts
A positive numberThe client's Websites may use at most that many credits this calendar month
ZeroAll metered work for that client stops. Reversible at any time

Because every client starts uncapped, nothing changes until you set a number. Zero is the quickest way to stop a client costing money, for example while a contract is paused, and you can undo it at once.

What counts against a budget?

Counted: metered work on that client's Websites, including AI visibility, rank and AI Shopping checks, audits, research, briefs, articles and client report narratives. "Used" includes credits held for work still running, so the bar you see matches the check RankX AI makes.

Not counted:

  • Your agency's own workspace. Your own work is never capped by a client allocation.
  • The free onboarding package. Setup paid for by RankX AI is not your money, so it never uses a client's allocation.
  • Work that failed. Credits are held before the work and released in full if it fails, so a failure leaves no spend behind.

When does the month reset?

Allocations run per calendar month. The counter resets on the first spend after the month turns, rather than in a scheduled sweep, so a client that spent nothing for two months starts the new month at zero all the same.

What does a client see when the budget runs out?

The work is refused with Client budget exceeded. RankX AI keeps this apart from its other credit refusals because the remedy is different.

RefusalRemedy
Not enough creditsAdd credits to the wallet
Subscription not activeReactivate the subscription
Client budget exceededRaise that client's allocation, or wait for the next month
Action not pricedNothing to change on your side. The message says so

Telling someone whose client is capped to buy credits would send them to do something that cannot work. See credits and metering.

How should I set a budget?

Start uncapped. Watch what a client actually uses for a month before deciding on a ceiling.

Size it from the recurring spend, which is nearly all of it: that client's prompts times assistants times runs, plus keywords times rank checks, plus shopping prompts times surfaces times runs. Then add room for the occasional audit and brief. Rates are in credit costs.

Leave real headroom. A ceiling set exactly at last month's spend stops the client the first time you run an extra audit, and the refusal lands on your team mid-task.

Use zero rather than pausing when you only want the spending to stop. Zero keeps every schedule as it is, while pausing the workspace stops the schedules and frees its slot on your plan.

Where to go next

Questions

When does a client's budget reset?

At the start of each calendar month. The counter resets on the first spend after the month turns, so a client who spends nothing for a while still starts the new month at zero.

What happens if I lower a budget below what the client has already used?

Nothing is clawed back. The client simply cannot start more metered work until the next month or until you raise the allocation again.

Can my client see their budget?

No. Budgets, the credit balance and billing are agency information, so an Agency Client never sees them.

Last updated

Cookie settings

Choose which cookies we can use. You can change this at any time from “Cookie settings” in the footer.

Essential

Security, bot protection and remembering your choice. The site needs them to run, and they do not identify you. Always on.

Google Analytics cookies that tell us which pages are read and which links are followed, so we can improve them. Off until you switch it on.

Tells advertisers when their advert led to your visit. Includes the Meta (Facebook) pixel and the LinkedIn Insight Tag, which set cookies on this domain (LinkedIn also on linkedin.com) and can be told if you later start a trial.

More in the cookie policy and the privacy policy.