Billing

​

Purpose

The Billing page is the central hub for customers to manage their financial relationship with Athena. It allows them to view their current subscription plan, track credit consumption, buy additional credits, distribute credits across their organization, and download invoices. Depending on the user’s role, the page adapts its layout. Organization admins and members see an organization-wide view that summarizes all workspaces, shared credit pools, and aggregate usage. External or website-only members see a focused, single-website view tailored only to the specific workspace they have been invited to.

​

What’s on the page

• View-only banner: A small notice at the top of the page that appears if the signed-in user only has view access to billing. It explains that they cannot make changes here.
• Billing hero card (Organization view): Combines the current subscription summary (plan name, status badge, and management buttons) with the organization’s shared credit pool summary.
• Usage / Websites & groups / Invoices tabs (Organization view): A tabbed interface below the hero card.
  • Usage: Shows credit consumption charts, a per-website breakdown, and an event-level credit log.
  • Websites & groups: Lists every website and billing-enabled group in the organization, along with its specific plan and credit balance.
  • Invoices: Shows the organization’s invoice history grouped by month.
• Plan cards (Website view, no plan yet): If a single-website user visits the page and their workspace is not yet on a paid plan, they will see pricing cards (Free, Starter, Enterprise) to help them subscribe.
• Subscription + credits card (Website view, has plan): For single-website users already on a plan, this shows their current billing cycle, a progress bar of their credit usage, and a button to buy or manage credits.
• Subscription management card (Website view): A secondary card providing access to the billing portal, options to renew or cancel a downgrade, and a button to view or change plans.
• Billing history / Invoices section: Displays past paid invoices, grouped by month, allowing users to download their receipts.

​

Websites & groups table (EntitiesTable, org view)

Lists every website and billing-enabled group in the organization, virtualized so large organizations can scroll smoothly.

• Website or group: Shows the logo/icon, name, and URL for websites, or a “Group” badge for groups. The currently active website and its associated groups are pinned at the top under a “Current website” label.
• Plan: The current subscription plan name as a badge, along with a status badge (e.g., Trial, Past due, Expired, Scheduled). “Active” plans show no status badge.
• Credits: The number of credits remaining versus the total, displayed with a progress bar and the next reset date. May also show an “Unlimited” badge or a dash if no plan exists.
• (actions): A three-dot (kebab) menu for websites, containing edit and delete options. For groups, an external-link icon that navigates to that specific group’s billing page.

​

Billing history invoices table (PaidInvoicesTable)

Shows paid invoices for the current billing scope (either the whole organization or a specific website) for a selected month.

• Date: The date the invoice was created.
• Amount: The total amount billed, displayed in the appropriate currency.
• Plan: The product(s) billed on the invoice (e.g., Growth, Starter, Credits).
• Status: A badge indicating if the invoice is “Paid” or “Pending”.
• Invoice: A button with an external-link icon that opens the actual hosted invoice page.

​

Credit usage tab. By website

A breakdown of how many credits were consumed by specific entities within the selected time range.

• Website/Group name: The name and URL of the entity, featuring a “Group pool” badge if it is a shared group.
• Credits used: The total number of credits consumed by that specific entity in the selected timeframe.

​

Credit usage tab. Credit log

An event-level ledger of individual credit charges, paginated for easy browsing.

• Time (UTC): The exact timestamp of the credit event.
• Website: The name of the originating website. May show “Deleted website” or “Not recorded” for older data. If the charge hit a group pool, the group’s name appears as a sub-line.
• Action: A human-readable label explaining what caused the charge (e.g., generating a specific type of content).
• Credits: The exact number of credits deducted for the action.

​

Drilldowns

• View plans / Plans & add-ons button: Opens the PricingPlansModal, showing the Free, Starter, and Enterprise cards. Allows users to compare features and upgrade.
• Buy credits / Manage credits button: Opens the BuyCreditAddOn dialog. Users can toggle between adding monthly recurring credits or buying a one-time package. It displays pricing, balance, and usage insights.
• Lock credits button: Opens the SplitCreditsDialog, giving administrators the tools to distribute the organization-wide shared credit pool to specific websites or groups.
• Row kebab menu → Edit website: Opens the EditWebsiteDialog to change the website’s name, URL, or settings.
• Row kebab menu → Delete website: Opens the DeleteWebsiteDialog to permanently remove a workspace.
• Group row external-link icon: Navigates the user to /group/[id]/billing to manage that specific group.
• Invoice row external-link button: Opens the official Stripe-hosted invoice PDF/receipt in a new browser tab.
• Billing portal / Manage subscription button: Opens the external Stripe billing portal (or partner portal) in a new tab to manage payment methods and billing details.

​

What you can do here

• View plans / Plans & add-ons: Opens a dialog to view pricing tiers and upgrade the current subscription.
• Billing portal: Opens the external billing portal in a new tab to update payment methods or download billing history. If the user does not have permission, this button is disabled and a tooltip explains they need billing write access.
• Buy credits / Manage credits: Opens a dialog to purchase additional credits. Inside this dialog, you can:
  • Add credits: Increment the quantity of credit packages you wish to buy.
  • Remove credits: Decrement the package quantity (can go down to 0 to cancel a monthly add-on).
  • Buy N credits / Cancel add-on: Confirm the purchase. This will either redirect to a checkout page or apply the changes immediately.
  • Cancel: Close the dialog without making changes.
• Renew plan: If a plan was previously canceled but hasn’t expired yet, this button opens a confirmation dialog. Confirming will resume the subscription so the billing cycle continues normally.
• Cancel downgrade: If a downgrade is scheduled for the end of the billing cycle, this opens a dialog to cancel the downgrade and keep the current plan.
• Lock credits: (Organization view only) Allows an admin to distribute the shared organization credit pool into dedicated allocations for specific websites or groups. Note: This is a destructive/permanent structural change to how the organization’s billing works.
• Edit website: Found inside the three-dot (kebab) menu on a website row in the Entities table. Opens the edit form.
• Delete website: Found inside the three-dot (kebab) menu on a website row. Opens a deletion confirmation dialog. Note: This is disabled with a tooltip if it is the organization’s only website, or if it has an active website-level subscription that must be canceled first.
• View all invoices link: A shortcut on the website view that navigates to the full invoice list.
• Export: Located on the Usage tab. Downloads a comprehensive CSV file containing the daily usage breakdown, per-website breakdown, and the full event log for the selected date range.
• Load more: Located at the bottom of the Credit log table. Fetches the next page of historical credit events.
• Get started / Subscribe now: Visible on the plan cards if the workspace has no plan yet. Creates the billing framework and redirects to checkout.
• Monthly / Annual toggle: Found above the plan cards, switches the displayed pricing between monthly and yearly rates.
• See all features link: Opens the public pricing page in a new browser tab.
• Get in touch: Located on the Enterprise plan card, opens a calendar scheduling link to book a call with the team.
• Month selector expand/collapse: Located on the organization Invoices tab; toggles the collapsible section that lists invoices for a specific month.

​

Filters

• Usage / Websites & groups / Invoices tab selector: Switches between the primary billing views for organization members.
• Invoice month selector: Filters the Billing history table to show only invoices generated in the selected month.
• Credit usage date range: A dropdown (Last 24 hours, 7 days, 30 days, 90 days, All time) that updates the charts, website breakdowns, and the credit log.
• Credit log website filter: Restricts the event-level credit log to only show charges originating from a specific website.
• Entities table search: A text input to quickly find a website or group by its name or URL.
• Entities table type filter: Toggle buttons to restrict the Entities table to “All”, “Websites”, or “Groups”.

​

Data shown

• Subscription plans and statuses: The active tier the customer is on (e.g., Starter, Enterprise), along with its current state (Active, Trialing, Past due, Canceled, Scheduled to downgrade).
• Credit balances and usage: How many credits have been spent versus the total allowance, including estimated daily run-rates and projections to help users avoid running out before their cycle resets.
• Invoices and payment history: Past billing receipts, including the date, amount, currency, and the specific products/plans being billed.
• Websites and groups: A directory of all the tracked entities belonging to the organization, allowing admins to audit which workspaces are consuming resources.

​

Common workflows

Buying additional credits

1. From the top of the Billing page, click Buy credits (or Manage credits).
2. Choose whether you want a Monthly recurring package or a One-time package using the tabs at the top of the dialog.
3. Use the + and - buttons to adjust the number of credit packages you need. The dialog will show you the total cost and your new projected balance.
4. Click Buy to confirm. You may be redirected to a secure checkout page to complete the transaction.

Exporting credit usage data

1. If you are an organization admin, navigate to the Usage tab.
2. Use the date range dropdown to select your desired timeframe (e.g., “Last 30 days”).
3. Click the Export button.
4. A CSV file will download containing a daily breakdown, per-website totals, and a granular log of every action that cost credits.

Renewing a canceled plan

1. If a subscription was canceled but the billing cycle hasn’t ended yet, a Renew plan button will appear on the Subscription card.
2. Click Renew plan.
3. A confirmation dialog will appear. Click Confirm to resume the subscription and prevent service interruption at the end of the month.

Downloading a past invoice

1. Navigate to the Invoices tab (or scroll down to the Billing history section on the website view).
2. Use the month selector to find the billing period you need.
3. Click the external link icon under the “Invoice” column for the desired row.
4. The official receipt will open in a new tab where it can be downloaded as a PDF.

​

Empty, loading, and error states

• Empty:
  • If a workspace has no plan, the page will state: “This website is not currently on a plan.”
  • If no payments have been made: “No invoices yet. Invoices will appear here after your first payment.”
  • If searching the entities table yields no results: “No websites or groups match your search” or “No websites or groups found.”
  • If filtering the usage log finds no data: “No credit usage found for this range” or “No credit events in this range.”
• Loading: A centered spinning loader appears while membership and billing data resolves. Skeleton lines (shimmering gray bars) act as placeholders inside tables, cards, and charts while their specific data fetches.
• Error: Failed actions (like a failed purchase or a broken portal link) will trigger a toast notification in the corner (e.g., “Failed to open subscription portal” or “An unexpected error occurred”). If the usage chart fails to fetch data, inline red text will appear in the card.

​

Linked from / links to

• Linked from:
  • The Settings navigation sidebar.
  • “Out of credits” warning prompts across the application.
  • Feature-gate upsell dialogs that redirect users to upgrade their plan.

​

Common support questions

Why does my page look different than my coworker’s? Organization administrators see a comprehensive view with tabs for “Usage”, “Websites & groups”, and “Invoices”. If a user was only invited to a single website and is not an organization-level member, they will see a simplified view that only shows the billing details for that specific website. Why is the “Billing portal” button grayed out? Only users with billing permissions (typically organization owners or admins) can access the external billing portal to change credit cards or billing addresses. If the button is disabled, hovering over it will explain that the user needs to request billing access from an administrator. Why is “Delete website” disabled? You cannot delete a website if it is the only workspace in your organization, or if it currently has an active website-level subscription. You must cancel the subscription before the workspace can be deleted. Why do some items in my credit log say “Not recorded”? Older credit events from before our detailed event-tracking system was implemented will show as “Not recorded” for the specific action or website. This is normal and expected for historical data; the total credit counts are still completely accurate. Why don’t I see the “Lock credits” button? The “Lock credits” feature is only available to organization admins when the organization has a shared pool of credits remaining. It will not appear if the organization’s credits are already split, if the organization is billed through a partner, or if the shared pool is currently zero.