Billing & Usage

The Billing Usage page lets you monitor your resource consumption and manage overage settings. Access it from Admin > Advanced > Billing Usage in your admin panel.

Overview

This page shows:

• Your current plan and its limits
• Real-time usage across all metered resources
• Overage credit balance and settings
• Options to upgrade or topup credit

Page Layout

Header Actions

The header displays action buttons based on your current plan and payment status:

Plan Limits & Overage Rates Card

This card displays your current plan information:

Plan Name

Shows your current subscription tier (Free, Starter, Professional, Premium, or Enterprise).

Included Limits

Six boxes showing your plan's limits:

Limits display as numbers or "∞" for unlimited plans.

Overage Rates

When overage is enabled, shows pricing for exceeding limits:

• Per 1,000 extra chunks
• Per 1,000 extra products
• Per 1,000 extra queries
• Per extra voice minute
• Per extra avatar minute
• Per extra AudioSpotlight product

Rates vary by plan tier. If overage is disabled, a message prompts you to enable it.

Alerts

The page displays alerts based on your usage status:

Approaching Limits

Shown when any resource reaches 67% or more. Suggests upgrading your plan.

Exceeded Limits

Shown when any resource exceeds 100%. Indicates overage charges are active (if enabled) or action is needed.

Overage Credit Balance Card

Credit Balance Display

Shows your current overage credit balance prominently with a Topup button (for paid plans).

Plan Details

Displays your plan name and monthly price (e.g., "professional plan at $89/month").

Automatic Top-up Toggle

Usage past your plan limits is always paid from your overage credit balance, whichever way this toggle is set. The toggle only decides what happens when the credit runs out:

Note: Free plan cannot use overage - upgrade required.

Usage Cards

Four cards display real-time usage for each metered resource:

Monthly Queries

• Current count of AI queries this billing cycle
• Limit from your plan
• Progress bar and percentage
• "Over limit" badge when exceeded

Chunks

• Current count of indexed document chunks
• Limit from your plan
• Progress bar and percentage
• "Over limit" badge when exceeded

Products

• Current count of catalog products
• Limit from your plan
• Progress bar and percentage
• "Over limit" badge when exceeded

Voice Minutes

• Current billed minutes this billing cycle
• Limit from your plan
• Progress bar and percentage
• "Over limit" badge when exceeded

Progress Bar Colors

Topping Up Overage Credit

Click Topup or Topup Overage Credit to add credit:

1. Available when overage is enabled and payment method exists
2. Enter the amount to add (defaults to your monthly plan price)
3. Review tax if applicable
4. Confirm to charge your payment method

When to topup:

• Before high-traffic periods
• When overage balance is low
• To ensure uninterrupted service

Plan Selection Dialog

When upgrading, a dialog lets you choose between:

Starter Plan

• $39/month
• 500 chunks
• 500 products
• 500 queries/month
• 240 voice minutes/month (4 hours)
• 60 avatar minutes/month (1 hour)
• 10 AudioSpotlights

Professional Plan

• $89/month
• 1,000 chunks
• 1,000 products
• 1,000 queries/month
• 540 voice minutes/month (9 hours)
• 180 avatar minutes/month (3 hours)
• 30 AudioSpotlights

Premium Plan

• $189/month
• 2,000 chunks
• 2,000 products
• 2,000 queries/month
• 1,200 voice minutes/month (20 hours)
• 600 avatar minutes/month (10 hours)
• 90 AudioSpotlights
• Dedicated database

Danger Zone

Close Account

Permanently closes your account and cancels your subscription. Hidden for enterprise plans.

Process:

1. Click Close Account
2. Review the refund summary:
   • Subscription refund (prorated for unused time)
   • Overage credit refund (unused balance)
   • Tax refund (if applicable)
   • Total refund amount
3. Type "CLOSE" to confirm
4. Click to proceed

What happens:

• Subscription cancelled immediately
• Refund processed to your payment method (if applicable)
• Account data scheduled for deletion
• Redirected to home page

Best Practices

Monitor Regularly

1. Check weekly - Review usage trends before limits are reached
2. Watch the alerts - Act when you see yellow warnings
3. Set reminders - Monthly check before billing cycle reset

Manage Overage Wisely

1. Enable proactively - Turn on before you need it
2. Keep credit balance - Maintain some balance for unexpected spikes
3. Review charges - Check billing statements for patterns

Plan for Growth

1. Track trends - If consistently near limits, consider upgrading
2. Compare costs - Overage rates vs. next plan tier
3. Upgrade timing - Upgrading before needing overage often saves money

Troubleshooting

Can't Turn On Automatic Top-up

• Free plan - Upgrade to a paid plan first
• No payment method - Add a payment method before turning it on

Can't Topup Credit

• Free plan - Upgrade to a paid plan first
• No payment method - Add a payment method first
• Payment failed - Check your payment method is valid

Usage Not Updating

• Refresh the page
• Usage updates may have slight delays
• Queries reset at the start of each billing cycle

Shopify Store Integrations

If you installed the app from the Shopify App Store, billing works differently:

• Billing handled by Shopify - All charges go through your Shopify account
• Monthly only - Annual billing is not available for Shopify tenants
• No payment methods page - Shopify manages payment information
• Simplified billing views - Some billing sections are hidden since Shopify handles transactions

See Setup Billing Plan for complete details on how billing works for Shopify stores.

Related Pages

• Dashboard - Quick usage overview
• Statements - View past invoices
• Payment Methods - Manage payment options
• Setup Billing Plan - Plan selection and Shopify billing