---
site: steel.dev
collection: docs
canonical_url: https://steel.dev/docs/platform/billing-and-usage
markdown_url: https://steel.dev/docs/platform/billing-and-usage.md
content_signal: ai-input=yes, ai-train=yes, search=yes
title: Billing and usage
description: See your usage, add credits, turn on auto top-up, set a spending limit, change your plan, and download invoices.
summary: See your usage, add credits, turn on auto top-up, set a spending limit, change your plan, and download invoices.
type: how-to
reviewed: 2026-11-12
prerequisites:
  - https://steel.dev/docs/platform/security-and-compliance.md
related:
  - https://steel.dev/docs/platform/pricing.md
  - https://steel.dev/docs/platform/limits.md
  - https://steel.dev/docs/platform/security-and-compliance.md
  - https://steel.dev/docs/platform/release-stages.md
agent_setup: https://setup.steel.dev/install.md
docs_index: https://steel.dev/docs/sitemap.md
---

# Billing and usage

The dashboard's billing pages show what your organization spends, and they are where you add credits and change the plan. On Launch and Scale, usage draws from a balance of credits. Keep the balance above zero, or new sessions are refused. The rates are on [Pricing](https://steel.dev/docs/platform/pricing).

The [dashboard](https://app.steel.dev/settings/billing) has these billing pages in its sidebar:

| Page | Group in the sidebar | What it has |
| - | - | - |
| **Usage** | Analytics | Your spend and usage over time |
| **Limits & Alerts** | Analytics | The spending limit, its email alerts, and your plan's limits |
| **Plans** | Plan & balance | The plans, and the buttons that change your plan |
| **Wallet** | Plan & balance | The balance, credit purchases, auto top-up, payment methods and invoices |

Any member can see the usage. Only an organization admin can add credits, set auto top-up, set a spending limit, change the plan, manage payment methods and see invoices. API keys cannot manage billing.

## See your usage

The **Usage** page shows, for the time range that you choose:

- Spend
- Sessions
- Browser minutes
- Proxy bandwidth
- CAPTCHA solves
- Scrapes

Choose a range from **Last 24h** to **Last 6 months**, and filter by project. Click **Export as CSV** to download the numbers with their cost. Your remaining balance is on the **Wallet** page.

Compare your usage with the rates on [Pricing](https://steel.dev/docs/platform/pricing) to see where the money goes. Your model provider bills model calls separately. A session that stays open while your agent waits for the model still uses browser time, so release each session when its work ends.

To get the cost of one session from your code, see [Session cost](https://steel.dev/docs/production/session-cost). To split the cost by your own customers, see [Track cost per customer](https://steel.dev/docs/production/track-cost-per-customer).

## Add credits

1. Open **Wallet** in the sidebar ([direct link](https://app.steel.dev/settings/billing/wallet)), and click **Buy credits**.
2. Under **Credit amount**, choose $50, $250 or $1,000, or choose **Other** and type an amount. One purchase is between $10 and $1,000. For a larger amount, [contact sales](https://steel.dev/enterprise).
3. Click **Continue to pay**. If no payment method is on file, Steel asks you to add a card first.
4. Check the payment method and total, and click **Buy**.

Credits that you buy expire 1 year after the purchase.

To add a payment method before you buy, click **Add card** under **Payment methods** on the **Wallet** page, and then **Save card**. To redeem a coupon code for credits, click **Redeem coupon** on the same page.

On Launch, Steel proxies and CAPTCHA solving need a verified account, and a credit purchase verifies it. See [Pricing](https://steel.dev/docs/platform/pricing#verify-a-launch-account).

When the balance runs out, Steel refuses new sessions with a `402` error and the code `insufficient_funds`. Sessions that are already running are not stopped. Add credits, and then create the session again.

## Turn on auto top-up

Auto top-up charges your payment method when the balance gets low, so a run does not stop for lack of credits.

1. On the **Wallet** page, under **Automatic top-up**, click **Configure**.
2. Set the amounts:
   - **When credits reach** is the balance that starts a top-up. It must be at least $5.
   - **Top-up amount** is what each top-up charges your payment method and adds to the balance. It must be between $10 and $1,000.
3. Click **Save**. If no payment method is on file, add a card when Steel asks for one, and click **Save & enable top-up**.

For example, with $20 and $100, a top-up starts when the balance falls to $20, and it raises the balance to $120. To change the amounts, click **Edit**. To turn auto top-up off, click **Stop top-up**.

Credit purchases and auto top-up need a usage-based plan, such as Launch or Scale. Legacy plans do not have them.

## Set a spending limit

A spending limit caps what your organization spends in a month. When the organization reaches it, Steel refuses new sessions with a `402` error and the code `budget_exceeded`. Sessions that are already running are not stopped. The limit resets at the start of the next month, in UTC.

To set, raise or remove the limit:

1. Open **Limits & Alerts** in the sidebar ([direct link](https://app.steel.dev/settings/billing/limits)), and click **Edit budget**.
2. Under **Budget**, type the monthly amount in dollars. To remove the limit, click **Clear budget**.
3. Click **Save**.

To get an email before you reach the limit, add an alert. Set the budget first.

1. Under **Alerts**, click **New alert**.
2. Choose the share of the budget, from 10% to 100%.
3. Click **Save**.

Steel sends each alert to your organization's billing email. An organization can have up to 5 alerts.

## Change your plan

An admin switches between Launch and Scale on the **Plans** page ([direct link](https://app.steel.dev/settings/billing/plans)). Scale raises the limits and lowers the rates. See [Limits](https://steel.dev/docs/platform/limits) and [Pricing](https://steel.dev/docs/platform/pricing).

- To upgrade, click **Upgrade to Scale**. Scale needs a payment method. Check the **Due today** amount, and click **Upgrade to Scale**.
- To downgrade, click **Downgrade to Launch**, and confirm with **Downgrade to Launch**. The plan menu's **Cancel plan** item does the same.

A plan change takes effect at once. Scale's monthly fee follows the calendar month in UTC. If you upgrade mid-month, Steel charges a prorated fee for the rest of the month right away. The dashboard shows it as **Due today**. You get Scale's full monthly credits at once, and they last until the end of the month. From the first day of the next month, Steel charges the full fee and gives the full credits each month. Unused monthly credits do not carry over to the next month. When you downgrade from Scale to Launch, you keep your unused credits until the end of the current billing period.

For Enterprise, [contact sales](https://steel.dev/enterprise). An Enterprise plan is managed by its contract, so you change it through your account team, not on the **Plans** page.

If your organization is on a [legacy plan](https://steel.dev/docs/platform/pricing#plans), you can keep it. Change to Launch or Scale when you choose.

## Download invoices

The **Purchase history** section of the **Wallet** page lists your invoices. The list includes subscription and usage invoices, credit purchases and automatic top-ups. Stripe processes and stores your payment details.

1. In **Purchase history**, click **View** on the invoice's row.
2. Click **Download document** to get the PDF from Stripe, or **Print Document** to print the page.

Some receipts for a single card payment, such as a credit purchase, have no PDF. They show **Print Document** only. If an invoice is still open, the page also has **Pay invoice**.

## Check that it worked

Open **Wallet**. The balance includes the credits that you bought, and **Purchase history** lists each credit purchase and automatic top-up. When auto top-up is on, **Automatic top-up** shows the two amounts that you saved, with **Edit** and **Stop top-up**. On **Limits & Alerts**, the budget shows the monthly amount that you saved, and **Alerts** lists each alert.

## Next steps

- [Pricing](https://steel.dev/docs/platform/pricing): See each plan's monthly price and its rates for browser hours, proxy bandwidth and CAPTCHA solves.
- [Session cost](https://steel.dev/docs/production/session-cost): Read what a single session cost from the API.
- [Track cost per customer](https://steel.dev/docs/production/track-cost-per-customer): Add up the cost of each customer's sessions.
