Documentation

Usage & Billing

The Usage page shows how much of your plan's resources you have used this month, including AI generations, hook tests, gallery scans, and media storage. The Upgrade page lets you change your plan o…

The Usage page shows how much of your plan's resources you have
used this month, including AI generations, hook tests, gallery
scans, and media storage. The Upgrade page lets you change your
plan or manage billing.

Usage:   Click the usage indicator at the bottom of the sidebar,
         or navigate to /usage.
Upgrade: Click "Upgrade" in Settings or the sidebar, or
         navigate to /upgrade.

The header shows your current billing period (month) and how
many days remain. Your plan tier is displayed as a color-coded
badge.

USAGE METERS (2x2 grid)

  AI Generations
    How many AI-powered generations you have used this month
    (captions, ideas, voice profiles, etc.).
    Shows: X / Limit (or "Unlimited" on higher tiers)
    Remaining count displayed below.

  Hook Tests
    Number of hook testing sessions used this month.
    Shows: X / Limit (or "Unlimited")

  Gallery Scans
    Number of AI media scans used for gallery tagging.
    Shows: X / Limit (or "Unlimited")

  Media Storage
    Total storage used for uploaded photos and videos.
    Shows: X MB / Y MB (or GB for larger amounts)

Each meter has a progress bar. The card border changes color
when you are near or at your limit:
  - Red border: At the limit (0 remaining)
  - Yellow/warning border: 80% or more used
  - Default border: Under 80% used

Four summary tiles below the meters:

  Posts Created    -- Total posts created
  Posts Published  -- Total posts marked as posted
  Campaigns        -- Total campaigns
  Brands           -- Total brand accounts

If you are near or at your usage limits, a banner appears:
  - Red: You have hit one or more limits
  - Yellow: You are approaching limits

The banner includes an "Upgrade Plan" button.

  Starter ($29/month)
    Core features, limited AI generations, 2 brands, basic
    storage allocation.

  Growth ($89/month)  -- Recommended
    More AI generations, 5 brands, expanded storage, additional
    hook tests and gallery scans.

  Pro ($199/month)
    Full AI access (unlimited or very high limits), team seats,
    priority support, maximum storage.

All plans include a 14-day free trial. You are not charged
until the trial ends.

1. Go to the Upgrade page (/upgrade).
2. Review the three plan cards showing features and pricing.
3. Click the button on the plan you want:
   - "Start Free Trial" if you are on the free tier
   - "Upgrade" to move to a higher plan
   - "Manage Plan" to switch plans
4. You are redirected to Stripe to complete the transaction.

If you are already on a plan, the Upgrade page shows a banner
with your current plan and a "Manage Billing" button.

Regardless of tier, every plan includes:
  - AI caption and content generation
  - Content idea generation
  - Hook testing
  - Brand document parsing
  - Email campaigns
  - Gallery scanning and AI tagging
  - Content calendar
  - Post tracking and scheduling
  - First comment scheduling
  - Multi-platform post preview
  - Social analytics
  - Performance reports
  - Approval workflows
  - Client review access

Click "Manage Billing" (from Settings or the Upgrade page) to
open the Stripe billing portal. From there you can:
  - Update your payment method
  - View invoices and payment history
  - Change your plan
  - Cancel your subscription

- Check the Usage page regularly to avoid hitting limits
  unexpectedly.
- If you frequently hit AI generation limits, consider
  upgrading -- higher tiers have significantly more (or
  unlimited) generations.
- Media storage counts all photos and videos in your galleries.
  Remove unused media to free up space.
- Usage meters reset at the start of each billing month.
- The free trial gives you full access to your selected plan's
  features for 14 days.

- 14-settings.txt (subscription info and billing portal access)
- 15-team-management.txt (seat limits by plan)
- 04-brands-account-manager.txt (brand limits by plan)