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?
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?
| Setting | Meaning |
|---|---|
| No allocation | Uncapped. The default, and where every client starts |
| A positive number | The client's Websites may use at most that many credits this calendar month |
| Zero | All 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.
| Refusal | Remedy |
|---|---|
| Not enough credits | Add credits to the wallet |
| Subscription not active | Reactivate the subscription |
| Client budget exceeded | Raise that client's allocation, or wait for the next month |
| Action not priced | Nothing 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
- Credits and metering, for the wallet model.
- Credits and billing, for usage reporting.
- Client Workspaces, for the unit a budget is set on.
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