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

# Billing

> View your organization's plan and subscription from Settings > Billing.

## Purpose

Use this page to see your organization's current subscription plan and, when paid plans exist, subscribe or change plans. Billing is managed by Clerk (AquaOps's identity and organization provider) — AquaOps itself doesn't run its own billing UI or store payment details.

## Best for

* checking which plan your organization is on
* subscribing to a plan once paid plans are available
* confirming billing status if something looks off

## Who can access this page

Go to:

```text theme={null}
Settings > Billing
```

Billing requires `org:manage` — the same wildcard permission covered in [Users and Roles](https://docs.aquaops.dev/user-guide/users-and-roles.md#the-orgmanage-wildcard). Anyone without it sees a "you don't have permission" message instead of the page, and the **Billing** link itself is hidden from the Settings navigation for them.

## What's on the page

The page embeds Clerk's pricing table, scoped to your organization. It shows:

* the plan(s) configured for organizations, with pricing and included features
* your organization's currently active plan
* a **Subscribe** (or equivalent) action per plan, which opens an in-app checkout flow if you select a different plan

> [!NOTE]
>
> As of this writing, only a **Free** plan is configured for organizations, so there's nothing to upgrade to yet — the page mainly confirms you're on the Free plan. If your organization is evaluating paid tiers, this is still the right place to look; new plans will appear here automatically once configured, with no other change needed on your end.

## What you can change here

If more than one plan exists, an `org:manage` user can subscribe to or switch plans directly from this page — Clerk handles checkout in an in-app drawer, and the change takes effect on your organization's subscription automatically. There's no separate "cancel" or "manage payment method" page inside AquaOps itself; those actions happen through the same Clerk-hosted billing flow when applicable.

There is nothing to configure here beyond plan selection — no invoices, usage limits, or seat management are currently surfaced on this page.

## Typical walkthrough

**1. Open Billing**

Go to `Settings > Billing`. You need `org:manage` to see this page.

**2. Review your plan**

Check which plan is marked as your organization's active subscription.

**3. Subscribe or change plans**

If a different plan is available and appropriate for your organization, select it and complete checkout in the drawer that opens.

## Best practices

* keep `org:manage` limited to the people who should be making billing decisions for the organization, same guidance as elsewhere in [Users and Roles](https://docs.aquaops.dev/user-guide/users-and-roles.md)
* check this page periodically if your organization is expecting new paid plans to become available
* if billing status looks wrong (e.g., a subscription you expected isn't reflected), contact support rather than assuming the page is broken — plan changes sync from Clerk and may take a moment to appear

## Suggested screenshots

* Billing page showing the pricing table with the active plan indicated
* the "no permission" state for a non-`org:manage` user
* the in-app checkout drawer mid-flow (if a second plan exists at the time of capture)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.