# Billing and Plans

Hosted billing is enabled: your Plan sets write allowance, retention, caps, and Live Updates.

Human page: /docs/billing
Markdown page: /docs/billing.md

## Plans

| Plan | Daily new Artifacts | File cap | Artifact and Bundle cap | TTL | Live Artifacts | Live Updates |
| --- | --- | --- | --- | --- | --- | --- |
| Ephemeral | 20 | 10 MB | 25 MB | 24h auto-delete | low-cap unclaimed Workspace | No |
| Free | 100 | 10 MB | 25 MB | 3d default, 7d max | 50 | No |
| Pro | 2000 | 25 MB | 100 MB | 30d default, 90d max | 1000 | Yes |

Shared caps: 100 files per Revision, 100 lifetime published Revisions per Artifact, 60 actor requests per minute, and 300 Workspace burst requests per minute.

## Upgrade

Open `/billing` in the dashboard and choose the Pro interval. The dashboard creates a Stripe Checkout session and redirects you to Stripe.

After a successful Checkout return, the dashboard activates Pro synchronously, refreshes the billing cache, and shows the updated Plan. Stripe webhooks and daily reconciliation keep local entitlement state converged after that.

## Manage subscription and invoices

The billing page can open Stripe Customer Portal for subscription management and cancellation. It also lists Stripe invoices with hosted invoice and PDF links when Stripe provides them.

Reads are always free. Billing changes write allowance and feature limits; it does not meter recipients opening an Artifact or Access Link.

## Subscription statuses

Stripe `active`, `trialing`, and `past_due` subscriptions map to Pro. Canceled, unpaid, incomplete, expired, paused, or missing subscriptions map to Free.