Credits
What credits are, what spends them, and when they come back.
On this page
Credits are the unit Modulify meters AI work in. Everything the model does on your behalf draws them down, and so does one thing that is not AI work at all: a site sending past its included emails.
Credits belong to a workspace
The balance sits on the workspace, not on your account. Everyone with access to a workspace draws from the same pool, and the work a teammate runs shows up as your balance falling.
If you belong to two workspaces you have two balances. Switching workspaces switches which one you are spending.
Only the workspace owner can buy more or change the plan. Anyone else who runs out sees the balance and the plan page, with the buttons disabled. On Free, credit packs are only offered once the owner has been on a paid plan. See Buy credits.
An extra workspace needs its own paid plan
The workspace you were given when you signed up gets its plan's credits on Free. A workspace you create yourself does not: on the Free plan it is allowed zero credits and its sites are locked. Put it on a paid plan and both come back.
What a balance is made of
Two pools add up to the number you see.
Subscription credits are the allowance your plan grants, refilled monthly on the paid plans. They are the number the progress bar measures.
Top up credits are packs you bought outright. They sit alongside the allowance and are not touched by the monthly reset.
The plan and credits window breaks both out under the bar, as Subscription credits 62 / 100 and Top up credits 200, alongside the reset date, Resets on Sep 1, 2026. The allowance takes its name from your plan, so it reads Free credits on Free and Enterprise credits on Enterprise.
Spending drains top up credits first, and only falls through to the subscription allowance once the top up pool is empty.
Where top up credits come from
Four things land in the top up pool, and none of them are cleared by the monthly reset.
- A credit pack you bought.
- The 5 credits a new workspace is given when the account was created through a Share and Earn invite link.
- The 5 credits Share and Earn pays into your default workspace when somebody creates their account through your invite link.
- The 50 credits Share and Earn pays into your default workspace the first time somebody you invited pays for a plan or a credit pack.
What spends credits
| Work | What it costs |
|---|---|
| A chat turn that builds or edits | Metered on the tokens the turn actually used |
| Generating or editing an image | 0.01 to 1.57 credits per image, depending on your plan and the model and size the site allows |
| Animating an image into a short video | 0.26 to 19.20 credits per clip, depending on your plan and the model, length and resolution the site allows |
| Sending more than the included emails in a month | 8 credits per extra 2,000 sends on Starter and Enterprise, 4 on Pro |
Images are added on top of the turn that asked for them, so a message that writes a section and generates two pictures is charged for both.
Email is the one line there that is not metered on AI work. Every site's included emails cost no credits at all: 50 a month on Free, 10,000 on Starter, 30,000 on Pro and 50,000 on Enterprise. A site that sends past them unlocks the next block of 2,000 sends on its own, and the workspace is charged that block's credits at the moment a send needs it, whether the site's own code, chat or a connected AI client sent it. Sends left over from a block carry over to the next month. A test email is free and never unlocks a block. A recipient is a send, so one message to five people uses five. A block is only ever bought on a paid plan. When the workspace does not have the credits for it, sending pauses for that site, the owner gets an email, and it starts again with the next email once credits are added. See When the workspace runs out of credits.
A chat turn has no flat price. A one-line copy change and a full page build run on the same rate and land on very different numbers, and you can read the real figure for any finished message from its Info row. See How work is sized.
See where your credits went
Open Plans from the workspace dropdown and pick the Usage tab, or go straight to /dashboard/plans/usage. Every member of the workspace can open it, not only the owner.
The date picker at the top is the one the Analytics tab uses: Today (from midnight UTC), Last day (the default, the last 24 hours), Last week, Last month, Last 3 months, Last year, All time or Custom range. Everything on the tab follows the period you pick, and time is counted in UTC. The tab keeps itself up to date while it is open, checking again every 30 seconds, so new charges show up without reloading the page.
The cards across the top show what the workspace spent in that period, after refunds:
- Total spent, everything together
- Building, chat turns that build or edit a site
- Images, images generated or edited
- Videos, images animated into clips
- Emails, the blocks of extra sends your sites unlocked past their included emails
- Other, older one-off charges, shown only when there are some
Clicking a card filters Every charge below to that kind, and Total spent shows every kind again. When work that did not finish gave credits back, a line under the cards says how many, for example 1.20 credits came back for work that did not finish, and are already taken off these totals.
Credits over time stacks the spending by kind, one bar per hour for Today, Last day and a custom range of a single day, one per day for Last week, Last month, Last 3 months and custom ranges up to 92 days, and one per month for anything longer. Hovering a bar shows the split. Credits by site ranks the sites that spent anything, with a bar for each, the top 8 by name and the rest added up in one line. A site that was deleted keeps its name with (deleted) after it, and spending that belongs to no site reads Not tied to a site.
Every charge lists each charge and refund, newest first: what it was (Chat turn, Images generated, Images edited, Video animated or 2,000 extra emails unlocked), the site, the date and time, and the credits. A refund carries a Refunded badge and a plus sign. It covers the same period as the cards, the picker beside the heading keeps one kind of charge, and Load more reaches older ones. With nothing in the period it shows No charges yet, Pick a longer period to see more. Charges are kept with no time limit.
Credits that come in, from the plan allowance, top ups or rewards, are not on this tab. The balance and the next reset are on the Plans tab.
What does not spend credits
Reading files, browsing your project, previewing, publishing and hosting are all free. So is everything the dashboard does: searching, moving projects between folders, inviting members, connecting a domain.
Running out of credits stops you building. It does not take your published site down.
Your plan changes the rate
The same work costs a different number of credits depending on the plan the workspace is on.
| Plan | Credit rate |
|---|---|
| Free | $0.25 per credit |
| Starter | $0.25 per credit |
| Pro | $0.50 per credit |
| Enterprise | $0.25 per credit |
A Pro credit is worth twice a Starter credit, and costs twice as much. Identical work bills half as many credits on Pro as it does on Starter. That is why Starter and Pro both show 100 included credits at $25 and $50: the credit counts match, the work they buy does not.
When credits come back
On a paid plan the subscription allowance resets at the start of each calendar month, and the balance card names the date: Resets on Sep 1, 2026. Modulify emails the workspace owner when it happens.
The reset refills the allowance. It does not clear top up credits, which carry on until they are spent.
A cancelled plan does not refill in the month it ends. Once you cancel, the reset on the 1st is skipped when your plan ends before the next 1st, and you keep spending what is left of the allowance until the end date. The balance card then reads Plan ends on Oct 3, 2026 instead of a reset date. A yearly plan you cancel keeps refilling every month until the month it ends in. If you resume the plan, the refill it skipped is added.
On the Free plan credits do not reset. A new account starts with 30 credits and is given 5 more a day for the next 4 days. Each top up lands 24 hours after the one before it, counted from the moment your account was created rather than at a fixed hour of the day. After the last one the free allowance stops growing, and nothing refills it. Accounts created before the daily top up existed already hold the whole free allowance.
While the daily top ups are still running, and once your spending has started drawing on the free allowance itself, the balance card swaps Credits reset monthly on paid plans for a countdown to the next top up, reading 5 free credits arrive in 7 hours. The wait is rounded down to whole hours, so the last stretch reads 5 free credits arrive in 1 hour and anything shorter reads 5 free credits arrive in less than an hour. In the plan and credits window that same sentence takes the place of Credits reset monthly on paid plans. Top up credits are spent ahead of the allowance, so while a credit pack or a Share and Earn reward is paying for your work the allowance is untouched. Until it is drawn on, whether because you have spent nothing at all or because top up credits are covering the work, the card keeps the plain Credits reset monthly on paid plans.
To get a recurring allowance you move to a paid plan. Credit packs can be bought on Free only once the workspace owner has been on a paid plan, and from then on at any time.
Stopping at zero
A turn is charged after it runs, so its real cost is only known at the end. While the turn runs your balance is watched, and the moment the work would take it past zero the run is stopped rather than carried on. Whatever it had already written is kept, and the reply stays in the thread under an amber Out of AI credits notice reading No AI credits remaining. Pick a plan or add credits to continue. On a Free workspace that cannot buy credit packs yet it reads No AI credits remaining. Pick a plan to continue. instead, and anyone but the owner is told to ask the workspace owner to add credits or to pick a plan.
Your balance never goes below zero. You are charged only what it could cover, and the small amount spent between the last check and the stop is absorbed rather than billed, so nothing is carried into the next month and nothing is held against a later top up. Every card and counter reads 0 until a reset, a daily top up or a credit pack puts you back in credit.
Running out
The strip above the chat box shows no balance while you have credits. When the balance reaches zero it reads 0 credits next to an Upgrade now button when you own the Free workspace that pays for the project, or Add credits when the workspace can buy credit packs, and the count on its own otherwise. Sending a message opens the plan and credits window instead of building. Messages already queued stop rather than being dropped, and the queue reads Paused because the workspace is out of credits.
On Free, while the daily top ups are still running, the strip carries the countdown under that balance too, as 5 free credits arrive in 7 hours.
Creating a new site from a prompt is refused the same way, and the plan and credits window opens instead.
If you are not the owner, Add credits is disabled with the tooltip Only the workspace owner can add credits.
From an AI client over MCP
get_workspace_credits returns the reconciled balance, get_workspace_credit_usage returns the totals, kinds and sites the Usage tab shows over time, for the same periods the date picker offers, and list_workspace_credit_activity lists the individual charges and refunds, which is how an assistant can answer where your credits went rather than only how many are left. All three need workspaces:read, ticked by default.
Buying credits is not available over MCP, because it charges a card.
See MCP tools.
Next
- Buy credits walks through a top up.
- Share and Earn earns credits by inviting people, with no card involved.
- Plans compares the included allowances.
- How work is sized explains what makes one turn cost more than another.