Working with tokens
Tokens are XBuild’s AI usage meter. Every plan includes an allowance, and AI work draws it down. Tokens are separate from seats: running out never blocks a teammate from signing in, and adding seats never adds tokens. One balance is shared across your company; anyone can spend from it, and only an Administrator can add to it.1. What consumes tokens
- Estimator chat is the main consumer. Cost grows with file processing, rounds of revisions, and scope complexity. One measurement file and a single package with little back-and-forth is light; many photos, several package variants, and repeated revisions use much more.
- Insurance publishing (Xactimate or Symbility) may add a token charge that’s separate from AI chat usage and managed supplement fees. Any charge, including for republishing or switching formats, is shown at the publish checkout for review before you confirm; completed charges appear in Billing → Transactions.
- Retail publishing: if a publish has a charge, review it at the publish checkout before you confirm, and check your account terms for current details. See Publishing your proposal.
2. Where tokens come from
Your balance is made up of grants, each with a source and its own expiration date:
XBuild spends the soonest-expiring grant first. Expired tokens leave the balance.
3. Check your balance
Open Billing from the main navigation or under Settings. The plan card shows Tokens remaining with a segmented bar, one segment per grant, color-coded by source. Point to a segment to see its remaining tokens, issue date, and expiration date. The Transactions tab lists purchases, plan grants, and publish charges; see Invoices and receipts.4. What happens at zero
When there aren’t enough tokens for an action, it pauses and XBuild shows an out-of-tokens prompt. Projects, proposals, and photos stay put. To continue, an Administrator can:- buy a manual top-up
- turn on auto-refill
- move to a plan with a larger allowance; see Changing your plan
5. Troubleshooting
- My balance dropped more than expected. Check Transactions for a first insurance publish or heavy chat sessions, and check whether a grant expired.
- I published twice but was charged once. Check your account terms for how republishes and format switches are handled.
- I have tokens but an action says I don’t have enough. The action’s full cost must fit in your balance.
- I can’t find a Top up button. Buying tokens is Admin-only.
- Do unused tokens roll over? Each grant keeps the expiration date shown on your balance.