Credits
What credits are, where to see your balance, and how to get more.
Credits are how Ploy meters AI work. Every time Ploy's Agent plans a change, writes code, or generates an image or a document, it spends AI credits from your organization's balance. Think of it as a fuel tank shared by every workspace in your organization.
Credits are spent while Ploy is actively building or editing your site. An idle workspace uses very few.
Three kinds of credit
Ploy meters three things separately. Each has its own allowance and its own meter, and they do not draw from each other.
| Credit type | What it covers |
|---|---|
| AI credits | Everything Ploy's Agent builds, writes, plans, or generates. |
| Visitor enrichment credits | Identifying the companies and people visiting your site. |
| Contact credits | A separate allowance, shown with the other usage meters. |
Running out of one does not affect the others. If visitor enrichment stops for the month, Ploy's Agent keeps building.
What spends AI credits
| Activity | Spends AI credits |
|---|---|
| Directly editing text in the site preview | No, in most cases |
| AI fallback for text that cannot be edited directly | Yes |
| Chatting with Ploy's Agent to build or edit a site | Yes |
| Code generation and planning | Yes |
| Image generation | Yes |
| Document generation | Yes |
| Ploybook runs, including scheduled ones | Yes |
| Visitors browsing your published site | No |
Longer chats cost more than short ones, because the Agent carries more context as the conversation grows. If you are making a series of unrelated changes, starting a new chat for each one is usually cheaper than one long thread.
What you get on each plan
Each plan comes with its own AI credit and visitor enrichment allowances, and Starter and Pro each offer several credit tiers. If your plan otherwise fits but the credits do not, you can move to a higher tier of your current plan rather than changing plans.
For current plan allowances and pricing, see the pricing page.
Tracking your balance
To review current usage and plan allowances, open Settings, then Organization, then Usage. The displayed balance and usage are organization-wide, including work from multiple workspaces.
You will see:
- Three separate meters, one each for AI credits, contact credits, and visitor enrichment, each showing usage against its own allowance for the current period.
- Your reset date, so you know when the next allowance arrives.
- Your current plan and credit tier, with the option to change either.
- An Earn 100 credits link, which opens your personal referral program.
Referral rewards are personal. You can see those credits on the Wallet page in account settings. Each person has one wallet, even if they belong to several organizations or workspaces.
Ploy's Agent also warns you in chat as you approach your limit, and tells you when you have run out. If a chat stops partway with an out-of-credits notice, the work is not lost. Add credits and the run picks up again.
Tip: check the meter before starting a large build, like a full site generation or a bulk content run. Those are the jobs most likely to run the tank dry mid-way.
Understand what used your credits
- Use Filter by user to narrow the usage shown.
- Choose Group usage by, then Chat, User, or Usage type.
- Switch the chart between Cumulative and Per day.
- Read What used your credits and page through the entries to review more activity.
Filters and grouping change the analysis view, not billing. Some activity may not have per-person attribution. Missing attribution does not mean no usage occurred.
Getting more AI credits
You can buy more AI credits in three ways from Settings then Billing:
- Move to a higher credit tier on your current plan: the fastest option if your plan otherwise fits. Pick the tier you want from the credit picker.
- Upgrade to a higher plan: Starter to Pro, for example. You get the new allowance immediately and pay only the prorated amount for the days left in your cycle. The exact amount is shown before you confirm.
- Talk to sales about Enterprise: for custom credit volume. The option to reach sales sits in the credit picker and at the bottom of the Pro plan card.
You can also add credits directly from any out-of-credits prompt in the product, which opens the picker pre-set one level above where you are. The prompt shows every plan side by side, with your current plan marked Current plan, so you can compare them before you choose.
Earn credits by referring a friend
Every person gets one stable referral code and a shareable link in the format ploy.ai/r/<CODE>. Your code does not change between workspaces or organizations.
- Share your referral link by copying it, sending an email, or showing the QR code.
- Your friend signs up through the link and verifies their email address. They receive 100 credits.
- If your friend subscribes to a paid plan, you receive 100 credits.
Referral credits go to each person's wallet, not to an organization's shared plan allowance. Each person has one referral code and one wallet.
Where to find your referral link
- The gift tile in the navigation footer.
- The Earn credits banner in the workspace switcher.
- Settings, then Organization, then Usage.
- The Wallet page in account settings.
Visitor enrichment credits
Visitor enrichment has its own monthly allowance set by your plan, and it does not touch your AI credits. Free plans do not include enrichment.
Each enrichment counts as one credit. To raise your allowance, move to a higher plan. If you need more than your plan includes, email support@ploy.ai.
Organization credits and workspace limits
Visitor enrichment is controlled by two separate values. Your organization visitor-enrichment credits are the shared credits available for the billing cycle. Each workspace also has a workspace enrichment limit that controls how many of those organization credits that workspace may use.
When a workspace reaches its limit, the warning includes Increase limit, which opens Settings → Enrichments. If the organization still has visitor-enrichment credits remaining, increasing the workspace limit can resume enrichment. Increasing the workspace limit does not add organization credits.
See Insights & Visitor Identification for how enriched visitors appear and what happens when a limit is reached.
When your cycle resets
Credit allowances follow your subscription billing cycle exactly. Each cycle starts with a fresh allowance.
Unused credits do not carry over. If you finish a cycle with credits left, they do not add to the next one. Plan larger builds inside a single cycle rather than saving credits toward them.
Downgrades take effect at the start of your next cycle, not immediately, so you keep the allowance you paid for until the cycle ends.
Visitor enrichment and contact credits follow the same cycle and reset the same way.
You may not need more credits
Before upgrading, it is worth checking whether you are spending credits on work you did not intend. Some things run on their own and draw from the same balance:
- Scheduled Ploybooks run whether or not you are watching. If you have one on a schedule you no longer need, pausing it frees up credits at no cost to you.
- A new Ploybook schedule ends after 90 days by default, and you get a reminder three days before it ends. Clearing the end date keeps it running until you disable it.
- Each active project runs a daily check-in, which is a scheduled Ploybook run and uses AI credits.
Ploy also gets more credit-efficient over time. The same build costs less than it used to.
What's Next?
- Ploy's Agent: how the Agent works, and prompt patterns that get more done per chat.
- Ploybooks: saved workflows and schedules, and how to manage the ones that run on their own.
- Visitor Identification: how enrichment turns site traffic into company and person insights.
- Working with a Team: how workspaces and organizations share a balance.
- FAQ and Troubleshooting: short answers to common questions.
Still stuck? Email support@ploy.ai and we will take a look at your account.