# Costs and budgets

The **Costs** tab says what your projects cost, who is behind it and whether that fits your budgets. It's on the Portfolio and on each project, for those who can see amounts. Without them there is no **Costs** tab.

- **Owner** and **Admin**: everything, including **Allocate** and cost classes for all projects.
- **Editor** with amounts: the tab, and the project's budgets and cost classes.
- **Viewer** with amounts: the tab.

The view bar, the states of a figure and Explain work as on the Portfolio: see [Read the Portfolio](portfolio-dashboard.md).

## Read the Costs tab

Open **Costs** on the Portfolio (press `4`, or the tab), or on a project. On a phone the tab row scrolls sideways.

### The cards

- **Costs · 30 days**: what the period cost, with its change, its share of the budget for those days ("189% of the budget for this period") and a bar. Each budget is scaled to the period's days, so a month's budget counts about a quarter on 7 days, and a period that spent fast can pass 100% while the month is fine. Budgets of one period add up; where a project has both a monthly and a yearly budget, they limit the same spend, so the tighter of the two counts. **Explain** says how much that budget is and, when only some projects have one, what those projects spent. **Month to date** reads the month's whole budget ("58% of this month's budgets"), the same as **Budget used**: a monthly budget whole, a yearly one a twelfth. On a project it splits into "$209.92 direct · $69.60 shared".
- **Month-end forecast**: where this month is heading, "≈ $689.05 by Nov 30 · based on the last 7 complete days". It shows on **30 days** and **Month to date** only.
- **Budget used**: this month's spend against the sum of the budgets on all spending, whatever the period, a yearly one at a twelfth; a project with both a monthly and a yearly budget counts the tighter one ($150 monthly and $1,200 yearly count $100). A project's spend counts once, however many budgets it has. "53% of this month's budget · 1 of 3 projects budgeted" says when only some projects have one. A budget on one provider isn't counted here; with only those, the card says "No budget on all spending".
- **Biggest change**: the provider that moved most, such as "Google Cloud billing +$51.00 vs previous 30 days".

Press a card to see how it was made. **See the rows →** leads back to the rows behind it, where it has them: **Month-end forecast** and **Biggest change** don't.

### The chart

**Costs by provider** stacks each day (each week or month over longer periods). **Daily**, **Weekly** and **Monthly** beside the heading change that.

1. Under the heading, choose **Provider**, **Service** or, on the Portfolio, **Project**.
2. Press a part of the chart, or a name in the legend, to filter the table under it to that part. The table shows **Filter** with what you chose. Press its cross to remove it.
3. A line marks the budget, such as "Budget $4.93/day". When only some projects have budgets, there is no line, and the chart says "No budget line: budgets cover 1 of 3 projects with costs."
4. Lines under the chart name unusual days: "Nov 2: OpenRouter 13.7× the 7-day average", or "Google Cloud billing $7.00, with nothing in the 7 days before".

See [Read a chart](portfolio-dashboard.md#read-a-chart) for the keyboard, touch and **Show as table**.

### The table

**Costs by provider and service** lists each one with its **Amount**, **Change**, **Share**, **Source**, **Class** and **Allocation**, and **Total** at the end. A provider with several services shows "2 services": press it to open them. On a phone each is a card.

**Source** says how sure a figure is. Hover, focus or tap the tag to read it:

| Tag | It says |
|---|---|
| `API` | "From the provider's billing API" |
| `EST` | "Estimated: plan price × usage" |
| `INV` | "From an invoice" |
| `MAN` | "Entered by hand" |

**Class** is **Variable**, **Fixed** or **Mixed** (see [Cost classes](#cost-classes)). **Allocation** says how a shared cost reaches this project: "24% of MailerSend · usage-weighted on emails sent", "40% of Upstash · fixed share". **Registrations** come from your obligations: "Registrations come from your obligations. If a provider also bills one, it counts in both rows."

On the Portfolio, a cost no project takes shows as "Unallocated · Upstash". Owners and admins get **Allocate**, which opens the binding review (see [Review bindings](review-bindings.md)).

With nothing in the period: "No costs in this period."

## Add a budget

Editors, admins and the owner, with amounts. A budget belongs to one project.

1. Open the project, press **Settings**, then **Budgets**.
2. Under **Add a budget**, type the **Amount** in the project's currency.
3. Choose **Monthly** or **Yearly** under **Period**.
4. Choose a **Provider** from the project's cost sources, or leave **All spending** ("Leave on All spending for the project's whole spend.").
5. Press **Add a budget**. The page says "Budgets are saved."

The list shows each one, such as "Monthly · All spending" and "Alerts at 80%, 100%". Press the remove button beside one to take it off.

A budget on **All spending** feeds the **Costs** card's bar, **Budget used**, the chart's line and a row in **Needs you** ("Atlas is at 112% of its $150 monthly budget", once this month's spend passes it). A budget on one provider feeds only its row in **Needs you**, which names the provider ("Atlas is at 106% of its $50 monthly OpenRouter budget"). At each threshold it raises an alert (see [Alerts](alerts.md)).

## Cost classes

The Revenue tab's P&L separates variable costs, which move with usage, from fixed ones. The class comes from the source until you set it.

1. Open the project's **Settings → Budgets** and go to **Cost classes**.
2. Owners and admins: choose **This project** or **All projects** under **Applies to**.
3. Beside a provider or service, choose **Variable** or **Fixed**, or **As the source says** to go back.
4. The page says "Saved. Figures update once they've been recomputed."

A project's class wins over one set for all projects, which then shows as "All projects: Fixed". With no costs in the last 12 months: "No costs in the last 12 months to class."

## When it doesn't work

| The page says | What to do |
|---|---|
| "Enter an amount of 0 or more, like 1500.50." | Type the budget as a number. |
| "Your access to this project doesn't include amounts, so its budgets aren't shown." | Ask an admin for **Can see amounts (revenue, costs, profit)**. |
| "That didn't save. Check your connection and try again." | The budget wasn't saved. Try again. |
| "That didn't save. Try again." | The cost class wasn't saved. Try again. |
| **Page not found** on **Costs** | Your access doesn't include amounts. |
