> ## Documentation Index
> Fetch the complete documentation index at: https://filla.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Billing

> Manage your Filla subscription, usage, and payment details.

## How Filla pricing works

**Build anything. Pay for what you process.**

Every tool on Filla is unlimited on every plan — forms, processor tools, document templates, and workflow automations. You only pay based on the number of **records processed** in your billing period.

## What counts as a record processed

A record is counted each time Filla performs a metered operation on your behalf — primarily writes to Airtable, plus tool operations that consume Filla compute.

| Activity                                             | Records counted |
| ---------------------------------------------------- | --------------- |
| Form submission (create or edit)                     | 1               |
| Processor tool run (per record successfully written) | 1 per record    |
| Document generated (per record)                      | 1 per record    |
| Bulk email sent (per recipient)                      | 1 per email     |
| Workflow automation (per Airtable write)             | 1 per write     |
| Form view, schema read, AI chat                      | 0               |

**Rule of thumb:** Anything that produced an outbound side effect — an Airtable write, a sent email, a generated document — counts. Reads, drafts, and AI conversations don't.

## Plans

|                    | Free                    | Starter       | Pro           | Business       |
| ------------------ | ----------------------- | ------------- | ------------- | -------------- |
| **Monthly price**  | \$0                     | \$19          | \$40          | \$99           |
| **Annual price**   | \$0                     | \$15/mo       | \$30/mo       | \$79/mo        |
| **Records**        | 20 (lifetime, no reset) | 2,500 / month | 5,000 / month | 15,000 / month |
| **Forms**          | 1                       | Unlimited     | Unlimited     | Unlimited      |
| **All tools**      | Unlimited               | Unlimited     | Unlimited     | Unlimited      |
| **Filla branding** | Required                | Required      | Removed       | Removed        |
| **Team seats**     | —                       | —             | Yes           | Yes            |
| **Cap behavior**   | Hard cap                | Hard cap      | Hard cap      | Hard cap       |

## Where billing appears in the dashboard

| Location                        | What it shows                                              |
| ------------------------------- | ---------------------------------------------------------- |
| **Plan card** (Settings page)   | Current plan, usage bar, renewal date, and billing actions |
| **Subscription card** (sidebar) | Plan name, status indicator, and usage progress bar        |

## Managing your subscription

Only the workspace **Owner** can manage billing. Go to **Settings** to access the Plan section.

From there you can:

* **Change plan** — switch between Starter, Pro, and Business. Changes take effect immediately with prorated billing.
* **Cancel** — cancel your subscription at the end of the current billing period. Your data stays intact.
* **Reactivate** — undo a pending cancellation before the period ends.
* **Update payment method** — opens the Polar billing portal to update your card.

## Upgrading your plan

<Steps>
  <Step title="Open Settings">
    Go to workspace **Settings** and find the **Plan** section.
  </Step>

  <Step title="Click Change plan">
    Select the plan you want and choose monthly or annual billing.
  </Step>

  <Step title="Confirm">
    Click **Confirm change**. Your new plan takes effect immediately. Billing is prorated.
  </Step>
</Steps>

## Canceling

Click **Cancel** on the Plan card in Settings. You can optionally share a reason for canceling. Your plan stays active until the end of the current billing period. After that, your workspace moves to the Free plan.

<Warning>
  Canceling does not delete your forms, tools, or data. Everything stays intact. You lose access to paid features like branding removal and higher record limits.
</Warning>

## Usage tracking

Your usage period depends on your plan:

* **Free plan** is a **lifetime allowance**. The 20-submission cap is one-time and **never resets** — once you've used your 20 submissions, further form writes are blocked until you upgrade to a paid plan.
* **Paid plans** use the **Polar billing cycle** — usage resets when your monthly or annual subscription renews.

You can see your current usage in three places:

* **Sidebar plan chip** — current plan + remaining records.
* **Persistent banner** at the top of every editor canvas — visible always on Free plans, and on Paid plans only when you're at 80% or higher. Click **Upgrade** to change plan inline.
* **Settings → Plan** — detailed usage bar with percentage, period start / end dates, and renewal info.

When you approach your limit:

| Threshold | What happens                                                                                                                          |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **80%**   | An email goes out (per period) and the persistent banner becomes visible on every paid editor.                                        |
| **100%**  | A second email goes out. The next submission, tool run, document generation, or bulk email is **blocked outright** — no grace window. |

The cap is hard on every plan. There's no automatic overage billing — to keep accepting submissions and tool runs after hitting the cap you upgrade. Paid plans also reset when their billing cycle renews; the Free plan does not.

## Tool runs are gated too

Tool runs respect the same cap as form submissions. When you're at the limit:

* Manually clicking **Run** in a tool editor returns "Workspace has reached its plan limit for this period."
* Webhook triggers return `429 Too Many Requests` with a `Retry-After` header.
* Scheduled (cron) tool runs are skipped for the period and resume automatically when usage frees up.

For tools that process record batches, the run stops cleanly at the plan boundary. If you have 5 records remaining and a tool would update 100, the first 5 are written and the run logs a "plan limit reached" warning before stopping. You upgrade or wait, then re-run for the rest.

## Common questions

<AccordionGroup>
  <Accordion title="What happens if I hit my record limit?">
    The next operation that would consume a record is blocked — form submissions, tool runs, document generations, and bulk emails all return a "plan limit reached" error. To resume, upgrade your plan or wait for the period to roll over. The cap is hard on every plan; there is no automatic overage billing.
  </Accordion>

  <Accordion title="What counts as a record processed?">
    Form submissions (creates and edits), processor tool record writes, generated documents, sent bulk emails, and workflow writebacks. AI conversations, schema reads, and form views don't count.
  </Accordion>

  <Accordion title="When does my usage reset?">
    The Free plan **doesn't reset** — your 20 submissions are a one-time allowance for trying out Filla. To keep collecting submissions after that you'll need to upgrade. Paid plans reset when your Polar billing cycle renews (monthly or annual).
  </Accordion>

  <Accordion title="Can I switch plans mid-cycle?">
    Yes. Changes take effect immediately and are prorated.
  </Accordion>

  <Accordion title="Do you offer annual billing?">
    Yes. Annual billing saves roughly 25%. You can switch between monthly and annual from the Change plan dialog.
  </Accordion>

  <Accordion title="Can I get a refund?">
    Contact support within 7 days of a charge if you need a refund. Refunds are evaluated case by case.
  </Accordion>

  <Accordion title="Do unused records roll over?">
    Paid plans don't roll unused records into the next billing cycle — your record count resets when the cycle renews. The Free plan is a one-time allowance and doesn't reset, so unused submissions stay available until you've used all 20.
  </Accordion>

  <Accordion title="Do AI form-builder runs count toward usage?">
    Drafting a form with the AI doesn't count. Only submissions to the live form (and other writes Filla makes on your behalf) consume usage. The AI builder reads your base and creates Airtable schema — that schema work isn't metered.
  </Accordion>
</AccordionGroup>
