Plans, Stripe and PayPal checkout, usage meters, invoices, and subscription management.
Billing (/billing, /pricing) manages your CookieShift subscription and usage limits.
Overview
The Billing page shows your current plan, subscription status, usage meters (scans, AI tokens, domains), plan upgrade cards, invoices, and Stripe customer portal access for payment methods.
Why it matters
Plan limits gate scans, exports, AI features, and team seats. Understanding billing prevents surprise blocks during launches and clarifies who can change payment methods.
Setup
- Sign in as a workspace owner (only owners upgrade and open Stripe portal).
- Open Billing or Pricing from Settings.
- Review Current subscription and Usage meters.
- Choose a plan card → complete Stripe or PayPal checkout.
- After payment, use Sync from Stripe if the dashboard has not updated within a few minutes.
- Invite teammates after upgrading seats — see Team management.
Examples
| Goal | Action |
|---|---|
| Upgrade Free → Pro | Select Pro card → checkout → Sync from Stripe |
| Add payment method | Manage payment methods → Stripe portal |
| Download invoices | Invoices table → download |
| Cancel renewal | Cancel at period end (access until period end) |
| Check AI headroom | Usage meters → compare to AI Usage |
Troubleshooting
| Symptom | Fix |
|---|---|
| Upgrade succeeded but plan unchanged | Wait 5 minutes; owner runs Sync from Stripe |
| Cannot change card | Must be workspace owner via Stripe portal |
| PayPal vs Stripe confusion | Same plan features — choose per finance policy |
| Feature still locked | Reload; confirm subscription status is active |
Best practices
- Keep billing owner on an account with 2FA enabled.
- Sync from Stripe after any external subscription change.
- Review usage meters before large scan or translation campaigns.
- Document which workspace owns production vs staging properties.
Page reference
Page sections
Owner actions
| Button | Who | Effect |
|---|---|---|
| Sync from Stripe | Owner | Refresh subscription state |
| Manage payment methods | Owner | Stripe customer portal |
Non-owners may see read-only billing notice.
Current subscription
| Field | Meaning |
|---|---|
| Current plan | free / pro / agency / enterprise |
| Status | active, trialing, past_due, canceled |
| Trial end | If trialing |
| Seats | Active users vs cap |
Usage meters
| Meter | Typical limit source |
|---|---|
| AI Tokens | Plan monthly allowance |
| Scans | Scans completed in period |
| Exports | PDF/CSV export count |
Animated progress bars show consumption percentage.
Plan cards
| Plan | Highlights (typical) |
|---|---|
| Free | 1 domain, 100 pages per scan, basic banner |
| Pro | Multiple domains, AI assistant, branding |
| Agency | Unlimited domains, 20,000 Shared Monthly Crawl Pages( Allocate Crawl ), per-website allocation (unlimited scans reuse allocation), Allocation Manager, Agency Management (/workspace/agency), +10,000 page packs via Stripe Checkout |
| Enterprise | Audit + priority support available now; advanced SSO/workflow hooks are rollout-dependent |
Popular badge may animate on recommended tier.
Checkout
| Provider | When shown |
|---|---|
| Stripe | Default card checkout |
| PayPal | When checkoutAvailable on overview |
Select chip before Upgrade. Return URLs: ?checkout=success / cancel.
Invoices
Table: date, number, amount, status. Download all when available. Fallback demo rows only in dev stubs.
Subscription lifecycle
| Action | Effect |
|---|---|
| Resume subscription | Undo cancel-at-period-end |
| Cancel at period end | Stops renewal; access until period end |
Plan comparison table
| Feature | Free | Pro | Enterprise |
|---|---|---|---|
| Domains | 1 | 10+ | Unlimited |
| Scans | Capped | High / unlimited | Deep scan |
| AI tokens | Limited | Higher | Custom + BYOK |
| Custom branding | Basic | Yes | Yes |
| Team seats | 1–3 | More | SSO + audit |
| Support | Standard | Priority | Dedicated |
Exact numbers shown on live plan cards in your dashboard. Plan cards may also display readiness badges to distinguish production-ready capability from foundation/preview or planned enterprise workflows.
FAQ
Upgrade succeeded but plan unchanged
Wait 5 minutes, reload, owner runs Sync from Stripe.
Who can change payment card?
Workspace owner via Stripe portal.
PayPal vs Stripe
Same plan features—choose per finance policy.