# Plans, Credits & Organizations

How to manage your Framo subscription, credits, and team — covering personal billing, top-ups, and organization (team) administration.

## Credits & Plans Overview

Framo runs on credits: every AI image, video, 3D model, and LoRA training run spends credits from your balance. Paid plans grant a monthly credit allowance that resets each month.

Plans (from `shared/pricing.ts`):

- **Free** — €0, 500 credits granted once (not monthly). Basic AI generation, 1 project, use existing LoRAs.
- **Pro** — €45/month (or €459/year, ~15% off). 6,000 credits/month, unlimited projects, commercial rights, own LoRA training, project sharing, password protection, 100 MB model uploads.
- **Max** — €85/month (or €867/year, ~15% off). 12,000 credits/month, everything in Pro plus LoRA model download (.safetensors) and priority support.
- **Enterprise** — Custom pricing (Contact Sales).

Annual billing applies a 15% discount on both Pro and Max.

## View & Manage Your Subscription

Lives in the **Account** section of the dashboard (left sidebar → **Account**, at the bottom).

The **Subscription** card shows your current plan name, status (Active / Cancels soon / Beta), billing interval, and renewal/access date.

- **Upgrade / change plan:** Click **Upgrade** (free users) or **Manage Plan** (active subscribers). Free users go to the pricing page; active subscribers open the Polar billing portal.
- **Manage Billing:** Click **Manage Billing** (shown when you have a Polar customer ID) to open the Polar portal for payment methods, invoices, and plan changes.
- **Cancel:** Click **Cancel subscription** at the bottom of the card, then confirm. You keep access until the end of the current billing period and can resubscribe anytime.

A pending plan change (e.g. a scheduled downgrade) shows as an amber notice with the effective date.

## Browse & Purchase Plans

To subscribe or change tier:

1. Go to the **pricing page** (`/pricing`), or click **Upgrade** in the Account section to open the upgrade dialog.
2. Toggle **Monthly** / **Yearly** at the top (yearly shows the 15% saving).
3. Click the plan button — **Get Started** (Free), **Upgrade to Pro**, **Upgrade to Max**, or **Contact Sales** (Enterprise).
4. New subscribers go through Polar checkout. Existing subscribers with a Polar account are sent to the Polar portal to switch plans (upgrade/downgrade/switch billing interval).

The button reflects your state: "Current Plan", "Upgrade to X", "Downgrade to X", or "Switch to Monthly".

## View Credit Pool & Usage (Personal)

Your live credit balance appears in the top bar credit counter. When you drop below 500 credits, a **Top Up** option becomes available there. The top-up dialog also warns if you already hold 500+ credits.

## Top Up Credits On Demand

Top-ups are one-time credit purchases that never expire. **Only Pro and Max subscribers can buy top-ups** (not Free or Beta Tester users).

Packs (from `shared/pricing.ts`):

- **Starter** — €20 → 2,000 credits
- **Boost** — €35 → 4,000 credits
- **Power** — €60 → 8,000 credits (best value, marked "Best Value")

To buy:

1. Open the **Top-up Credits** card in the Account section, or the Top Up dialog from the credit counter.
2. Click **Buy €X** / **Purchase** on a pack.
3. Complete Polar checkout. Credits are added instantly on return (no waiting for the webhook).

## The Onboarding Flow (New Users)

New accounts receive **500 free welcome credits** once (Free plan). Note: welcome credits are granted a single time per identity — deleting and recreating an account does **not** grant them again. See [Sign-in, account & public pages](/docs/product/auth-account).

If you purchased a team plan (Team / Business / Academic / Enterprise) but have no organization yet, the dashboard shows a **"Set up your organization"** banner. Click **Get started** to create your org (see below).

---

# Organizations (Teams)

Organizations give a team a shared credit pool, members, groups, and consolidated billing. Org admin pages live under **Settings → Organization** (`/settings/org`) and are visible only to org admins. The left nav has: **Settings**, **Members**, **Groups**, **Billing**, **Usage**.

## Create an Organization

1. Go to `/onboarding/org` (or click **Get started** on the dashboard org-setup banner).
2. Enter an **Organization name** and pick a **type** (Agency, Studio, School, University, Other).
3. Click **Create organization**. You become the org **Admin (owner)** and are taken to the org billing setup.

A self-created org starts with a 0 credit pool — credit allocation is provisioned by Framo (see Billing below).

## Invite & Manage Members

Go to **Settings → Organization → Members**.

**Invite by email:**
1. Click **Invite member**.
2. Enter the email and choose a role: **Member**, **Group Admin**, or **Admin**.
3. Click **Send invite** — an email invite is sent.

**Invite by link:**
1. Click **Invite link**.
2. Choose the role new joiners get, click **Generate link**, then copy it. The link expires in 30 days.

**Pending invites** are listed below the members table with their role and expiry; click **Revoke** to cancel one.

**Manage existing members:** In the members table, use the row **⋯** menu to **Suspend** or **Remove** a member. (The owner and yourself cannot be acted on.) Each row shows the member's role, credits used (and cap if set), and status.

**Access control** (Settings tab): set an **allowed email domain**, toggle **Allow self-join** (anyone with that domain joins without an invite) and **Require approval** (new members need admin approval).

## Create Groups & Allocate Credit Budgets

Groups are sub-teams with optional monthly credit budgets. Go to **Settings → Organization → Groups**.

1. Click **New group**.
2. Enter a **Name**, optional **Description**, and an optional **Monthly credit budget** (leave blank for no limit).
3. Click **Create group**.

To edit a group, add/remove members, or delete it: click the pencil icon on the group row. Use the **+** in the Members section of the dialog to add active members; click the **×** on a member pill to remove. Each group row shows credits used and remaining-of-budget plus member avatars.

## Monitor Org Credit Usage

Go to **Settings → Organization → Usage**.

- Summary cards: **Pool remaining** (of monthly allocation), **Used this cycle** (% of pool), and **Active members** count.
- **Member usage** table: per-member credits used and credit cap (if assigned), sorted by usage.
- **Group usage** table: per-group credits used, budget, and remaining.

Usage reflects the current billing cycle; the pool resets on the 1st of each month.

## Org Billing & Invoices (Overage)

Go to **Settings → Organization → Billing**.

- **Subscription** card: plan (Team / Business / Academic / Enterprise), status, last reset, and next reset (1st of next month).
- **Credit pool**: a usage bar (used this cycle / monthly allocation) and credits remaining. Org credit allocation is **managed by Framo** — contact Framo to adjust it.
- **Invoice history**: a table of monthly billing snapshots. Months where you used credits beyond your allocation show an **Overage** amount and an **Invoiced** / **Due** status.

**Download an invoice (overage):** For any month with overage, click the **PDF** button in that row to download the invoice. Months with no overage show as "Included" and have no PDF.

## Configure Org Settings & Branding

Go to **Settings → Organization → Settings** (the **Settings** tab, `/settings/org`).

- **General:** edit organization **name** and **type**.
- **Access control:** allowed email domain, self-join, require-approval (see above).
- **Projects:** **Allow personal projects** toggle, and **Default project ownership** (Organization-owned vs Member-owned).
- Click **Save changes** to apply.

**Billing details** (shown on PDF invoices): set **Billing address** (company, address, VAT/tax ID), **Billing email** (where invoice copies go), and an **Invoice prefix** (e.g. `MILAN` → `MILAN-2026-04-0001`; blank defaults to `FRAMO`). Click **Save billing details**.

**Org logo / branding:** on the **Members** page, use the **Organisation** card at the top — click **Upload logo** / **Change logo** (PNG, JPG, SVG). Any member can update it.

## Delete an Organization

Owner-only. Go to **Settings → Organization → Settings** and scroll to the **Danger zone**.

1. Click **Delete**.
2. Type the organization name exactly to confirm.
3. Click **Delete organization**. This permanently deletes the org and removes all members — it cannot be undone.

## Manage Billing via the Polar Portal

Framo billing (cards, invoices, plan changes) is handled by Polar. Open the portal from:

- The Account **Subscription** card → **Manage Billing** or **Manage Plan**, or
- The pricing page when you're an existing subscriber (plan-change clicks route there).

The portal opens in a new tab with your payment methods, billing history, and subscription controls.
