# Pie assistant credits

> How the weekly AI allowance works: what uses credits, how much each plan gets, where the meter shows, when it renews, what happens at zero, and top-up packs.

Source: https://docs.personacart.com/pieos/ai-credits

In short: {"How the weekly AI allowance works: what uses credits, how much each plan gets, where the meter shows, when it renews, what happens at zero, and top-up packs."}

Your store has a weekly allowance of AI work, counted in credits. Pie, page generation, product copy and buyer chat all draw from it. It is weekly, not monthly.

1. Open the account menu at the top right and read **[N]% used**.
2. Press the percentage to see where the credits went.
3. Open Settings → Billing → Usage and check the **PieOS** top-up packs.
4. To add credits, pick a pack and press **Pay now**. To get a bigger weekly allowance, open the **Your plan** tab and press **Change plan**.

## Where to find it

The meter sits in the account menu in the top bar. The full breakdown is in Settings → Billing → Usage.

## How much you get

The weekly allowance by plan (as of October 2026):

| Plan | Credits per week |
|---|---|
| Starter | 1,000 |
| Pro | 5,000 |
| Scale | 20,000 |

One credit is about 1,000 tokens of AI work, so you do not need to count anything yourself: the meter does it for you. Full plan numbers are on [Plans, limits and what is included](/settings/plans-and-limits).

## What uses credits

Anything you start that uses AI draws from the allowance, for example:

- Talking to Pie in [chat](/pieos/chat).
- Generating pages and sections, writing product copy, SEO text, courses and curricula.
- Insights and imports that use AI.
- **Buyer AI** replies on your storefront (see [Storefront chat](/pieos/storefront-chat)). They use the same allowance as you do.

Pie working for your store on its own is shown separately on your usage screen as **Pie for your store: FREE — not in your quota**.

## Check your meter

| Where | What it shows |
|---|---|
| The account menu in the top bar | A ring and **[N]% used**, with **Resets in [time] · [plan] plan** underneath. Press the headline to see where it went. |
| Under Pie's chat, once a conversation has begun | A one-line version: "AI [N]% used · resets in [time]". |
| Settings → Billing → Usage | **AI usage this week**: "You've used [N]% of this week's AI", broken down by what it went on (Pages & sections, Chat, SEO, Writing, Courses, Imports, Insights, Buyer AI). |
| Settings → Usage, the **PieOS** group | Plan quota used this week and this month, what is left, resets, and the split between **Pie chat**, **Buyer AI** and **Other**. |
| Buyer AI, **Get ready** and **Chat widget** tabs | The same meter, beside the switch that spends it. |

## What the meter colours mean

| State | Looks like | What to do |
|---|---|---|
| Plenty left | Green ring, "[N]% used" | Nothing. |
| Getting full | Amber, then rose as it fills | Once it is nearly full, an **Upgrade** button appears if a higher plan exists. |
| Out | Grey ring, **Out of tokens** | **Get more tokens** appears. Pie waits for the renewal. |
| Covered | Blue, **Covered by your AI pack** | Your top-up pack is paying for the work. |

## When it renews

Each store has its own 7-day cycle. The usage screen shows the exact date and time it renews, so you never have to guess. Credits do not roll over.

## If the allowance runs out

- You are emailed as you get close (at about 80 percent) and when you have reached the limit.
- Pie and the AI tools in your dashboard stop until the allowance renews. A message says **You've reached your AI limit** and when it renews ("It renews at [time] today", or on a date).
- Your buyers are not left with an error. Storefront chat hands them to a person instead, and the conversation lands in your [Support Inbox](/commerce/support-inbox). When the allowance is short, buyer chat is the first to give way.
- Your store keeps selling. Orders, payments, bookings and pages do not depend on credits.
- If PersonaCart has paused AI, you see **AI is paused** ("Please try again later") instead.

## Add a top-up pack

If you run out before the week is over, a top-up pack adds AI work on top of the allowance.

1. Open Settings → Billing → Usage.
2. Choose a pack: **PieOS 1x**, **PieOS 5x**, **PieOS 20x** or **PieOS 100x**.
3. Press **Pay now**.
4. Turn on **Spend my top-up automatically** if Pie should keep working on the pack when the allowance runs out.

- It is a **one-time charge**, not a subscription, and a pack **never expires**.
- A pack is only used after your plan's weekly allowance is used up.
- The switch **Spend my top-up automatically** decides whether Pie keeps working on your pack when the allowance runs out. When it is off, your pack stays untouched and Pie waits for the allowance to return.
- Card details go straight to Stripe. PersonaCart never sees them.

Top-ups are offered where available. If the page says no top-up is on sale for your plan or billing region, none can be bought there yet. A plan with unlimited AI does not need one.

:::note[Buyers use your credits too]
Every buyer chat reply comes from the same weekly pool as your own work. A busy storefront can use it up before you do. When it runs out, buyers are handed to a person, not shown an error.
:::

## Good to know

- The allowance counts the AI work itself, not what you sell. Sales never use it up.
- Each buyer chat reply uses the same pool as your own work, so a busy storefront can use it up before you do.
- Before some large jobs, Pie may tell you "This will use about [N]% of your remaining weekly AI budget", or that it is too big and to try a smaller job or wait for the reset.

## Questions
