> ## Documentation Index
> Fetch the complete documentation index at: https://docs.molin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# How credits work

> Understand the different types of Ninja credits, the order they are used in, and how your balance is calculated.

Every task you run on [Ninja](https://ninja.new) costs credits. This page explains where credits come from, the order in which they are spent, and how the total you see in your dashboard is calculated.

## Types of credits

You can hold up to four different types of credits at the same time. Each one has its own rules about when it refills and whether unused credits roll over.

| Type                     | Refills when                    | Rolls over?                  | Where it comes from                                                                    |
| ------------------------ | ------------------------------- | ---------------------------- | -------------------------------------------------------------------------------------- |
| **Purchased credits**    | Never automatically             | Yes, kept until used         | Your signup bonus, paid top-ups, referral rewards                                      |
| **Free daily credits**   | Every day at 00:00 UTC          | No, unused credits are lost  | Every account, including paid plans, gets 100 free credits per day                     |
| **Plan monthly credits** | When a new billing cycle starts | No, reset at the cycle start | Your paid plan's monthly allowance (Plus = 2,000/month, Pro = 15,000/month, and so on) |
| **Promo credits**        | Defined per promo               | No, expire at promo end      | Time-limited promotions (e.g. a launch event that grants every shop extra credits)     |

The most important distinction is between **purchased credits** (which accumulate over time) and **free daily / plan monthly / promo credits** (which are usage caps that reset and do not carry over).

## Free daily credits do not stack

Free daily credits are a budget that refills, not a deposit. If you don't use Ninja today, you still start tomorrow with 100, not 200. Unused credits are lost at midnight UTC.

Plan monthly and promo credits work the same way. Only purchased credits roll over indefinitely.

## In what order are credits spent?

When you run a task, Ninja drains your credit buckets in this exact order:

1. **Promo credits** first
2. **Free daily credits** next
3. **Plan monthly credits** next (if you are on a paid plan, oldest active billing cycle first)
4. **Purchased credits** last

The system moves to the next bucket only when the current one is empty. A single task can be paid for from multiple buckets at once. For example, a 50-credit task could be covered by 30 promo credits + 20 free daily credits.

This order is designed to drain the credits that expire soonest before touching the ones you have paid for.

## How your "credits remaining" total is calculated

The single number you see in your dashboard is the sum of all four buckets:

```
Credits remaining = Purchased + Promo remaining + Free daily remaining + Plan monthly remaining
```

So a Free-plan user with no purchased credits and a full daily bucket will see **100**. A Plus user at the start of their billing cycle with 500 purchased credits and a full daily bucket will see **500 + 100 + 2,000 = 2,600**.

## Worked example 1: a Free-plan user, two tasks in one day

Anna signs up and receives a 500-credit signup bonus.

| Day           | What she does                   | Buckets after                                                                                                      |
| ------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| 0             | Signs up                        | Purchased: 500, Free daily: 100/100 → **total 600**                                                                |
| 1             | Runs a task that costs 30       | Free daily covers all 30. Free daily: 70/100 → **total 570**                                                       |
| 1             | Runs another task that costs 80 | Free daily covers the first 70, the last 10 come from purchased. Purchased: 490, Free daily: 0/100 → **total 490** |
| 2 (00:00 UTC) | Free daily resets               | Purchased: 490, Free daily: 100/100 → **total 590**                                                                |
| 2             | No usage                        | Same → **total 590**                                                                                               |
| 3             | No usage                        | Same → **total 590**                                                                                               |

Notice that the total stays at 590 from day 2 onwards. The 100 free daily credits refill her bucket, they do not add to her purchased balance.

## Worked example 2: a paid-plan user

Bela is on the Plus plan. He gets 2,000 monthly credits + 100 free credits per day, and he also has 500 purchased credits from a previous top-up. His billing cycle just renewed.

He runs a single task that costs 250 credits.

| Bucket                       | Before | Spent on this task | After |
| ---------------------------- | ------ | ------------------ | ----- |
| Promo                        | 0      | 0                  | 0     |
| Free daily                   | 100    | 100                | 0     |
| Plan monthly (current cycle) | 2,000  | 150                | 1,850 |
| Purchased                    | 500    | 0                  | 500   |

The task drained all 100 of today's free credits and 150 from his monthly allowance. His purchased credits were not touched — they are kept for when his monthly allowance runs out later in the cycle.

## Worked example 3: a promo period

The "Nano Banana Launch" promo grants every shop on Shopify, UNAS, Shoprenter, Shoper, and Scraper feeds an extra 10,000 credits for 5 days.

Csilla starts the promo with 200 purchased credits and a fresh 100 daily bucket. She runs a single task that costs 3,000 credits.

| Bucket     | Before | Spent | After |
| ---------- | ------ | ----- | ----- |
| Promo      | 10,000 | 3,000 | 7,000 |
| Free daily | 100    | 0     | 100   |
| Purchased  | 200    | 0     | 200   |

The promo bucket is drained first because it is the highest priority, so her purchased and free daily credits are untouched. The remaining 7,000 promo credits stay available until the promo ends, after which any unused promo credits disappear.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="My balance has not changed in days, even though I'm on the Free plan. Where are my 100 credits per day?">
    The Free plan gives you 100 credits **of usage per day**, not 100 credits added to your balance each day. Unused free credits do not carry over. If you do not use Ninja today, tomorrow you will
    still start with 100, not 200.
  </Accordion>

  <Accordion title="What is the maximum balance I can reach on the Free plan?">
    The Free plan does not grow your balance over time. It gives you a 100-credit daily usage budget that resets every day at 00:00 UTC. To accumulate credits, you need to buy a top-up, earn referral
    rewards, or subscribe to a paid plan.
  </Accordion>

  <Accordion title="I see a negative number in my balance. Did I get charged?">
    No, we never bill you money for credit overruns. A negative number means a past task cost more than the credits available in your daily, monthly, and promo buckets, so the difference was taken
    from your purchased balance and pushed it below zero. You will not be able to run new tasks until your balance returns to zero or positive, which happens when you upgrade to a paid plan, buy a
    top-up, or a promo period covers your usage. If you think your balance is wrong, contact [support](mailto:hey@molin.ai).
  </Accordion>

  <Accordion title="I received credits during a promo. Where did they go?">
    Promo credits live in a separate bucket from your purchased balance. They are spent first (before your free daily, monthly, or purchased credits) and they expire when the promo ends. Any unused
    promo credits at the end of the promo period are forfeited.
  </Accordion>

  <Accordion title="Do my paid monthly credits roll over to next month?">
    No. Your monthly plan allowance resets at the start of each billing cycle, so unused credits from the previous month are lost. If you regularly have a lot of credits left over, consider
    downgrading to a smaller plan and topping up purchased credits as needed.
  </Accordion>
</AccordionGroup>
