> Agent-readable docs index: /docs/llms.txt. Full docs in one file: /docs/llms-full.txt. Download /docs/docs.zip to grep all markdown files locally.

---
title: Billing
"og:image": "https://libretto.sh/docs/og/libretto-cloud-hosting/billing.png"
---

> View your current cloud plan, open the Libretto plans page, and manage payment details through Stripe.

Only organization owners can view billing status or open billing-management links.

<Warning>
  Sign up or log in to your Libretto Cloud account before using these commands.
</Warning>

### Open the plans page

Use `billing portal` to print a short-lived link to Libretto's plans page:

```bash theme={null}
npx libretto cloud billing portal
```

The page shows:

* Your current plan.
* The currently available upgrade or downgrade options.
* A link for payment methods and invoices.
* A contact path for BAA and Enterprise requests.

### Check the current plan and usage

Use `billing status` to inspect the current plan, subscription status, usage, and period end:

```bash theme={null}
npx libretto cloud billing status
```

Example output:

```text
Plan:    Team (active)
Usage:   26.40 / 400 browser hours this period
Period:  ends 2026-05-21
```

If cancellation is already scheduled, the command prints that too.

### Cloud usage limits

These limits apply to Libretto Cloud. Local browser sessions on your own machine do not count toward cloud billing.

#### What counts toward usage

Browser hours accrue when Libretto Cloud provisions a browser session for:

* A browser session opened through Libretto Cloud.
* A workflow job that needs a browser session.

#### How usage is measured

Hosted usage is measured per browser session, from the time a session starts until Libretto records it as closed.

Each session is billed by the second and rounds up to the next whole second, with a one-second minimum per session. Browser seconds are priced at **$0.000069444 per second** (**$0.25 per browser hour**), which is reflected in the included hours on each plan.

#### Plans and pricing

| Plan       | Monthly price | Browser hours included |
| ---------- | ------------- | ---------------------- |
| Free       | $0            | 1                      |
| Pro        | $20           | 80                     |
| Team       | $100          | 400                    |
| Enterprise | Custom        | Custom                 |

Run `billing portal` to compare and switch plans.

If your organization exceeds its plan limit, Libretto Cloud will not spin up new browser sessions until you move to a plan with more capacity.

### Change plans, payment methods, invoices, and cancellation

Run `billing portal`, open the printed plans page, and use it to change plans or open Stripe's customer portal for payment details, invoices, and cancellation. After any plan change, run `billing status` again in your terminal to confirm the updated plan.

### BAA and Enterprise

The hosted Libretto Cloud platform is fully HIPAA compliant. If you need a BAA
(which does not require an Enterprise plan) or want to discuss an Enterprise
plan, please reach out to us at `team@libretto.sh`.

### Troubleshooting

* If the plans link says it is expired or invalid, run `billing portal` again to get a fresh link.
* If billing commands fail with an auth error, log in again or set `LIBRETTO_API_KEY`.
* If you can authenticate but still cannot access billing, confirm that your user is an organization owner.

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/libretto-cloud-hosting/authentication">
    Manage cloud login state, invites, and API keys.
  </Card>

  <Card title="Deployments" icon="rocket" href="/libretto-cloud-hosting/deployments">
    Deploy workflows and invoke them on Libretto Cloud.
  </Card>
</CardGroup>