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

# Usage and plan

> Track the identifications you used this billing cycle, see when usage resets, change plan and manage billing.

<Note>
  This page describes the new analytics dashboard, which is rolling out to all accounts.
</Note>

**Usage** shows how many identifications your account used in the current billing cycle, when usage resets, and which plan fits your volume. Your plan counts identifications, one per check by the snippet, across all your domains. The side rail shows the same usage as a percentage next to **Usage**, and the plan card at its foot shows your plan, its renewal date and the identifications used, with **Change plan** opening Usage. Usage and Settings cover the whole account, so the period and domain pickers of the other screens do not apply here.

## Identifications this billing cycle

The **Identifications** card shows the dates of the billing cycle, the share used, **Used** and **Remaining**, your **Included volume**, and the date **Usage resets on**. The meter follows the billing cycle, not the period selected on other screens.

Only identifications count. Opening the analytics dashboard, exporting, and reading through the History API use none of your included identifications. On the snippet side, `checkAnonymous` and `checkAuthenticatedUser` run at most one identification every five minutes for the same user in the same browser, shared across open tabs. A call inside that window posts nothing, counts nothing, and its `onInitialized` handler receives `{ status: "not_initialized" }`. [Optimizing usage](/setup/optimizing-usage) shows where to place calls.

<Frame caption="Included identifications for the billing cycle, in the analytics dashboard's Usage screen.">
  <img className="block dark:hidden" src="https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/usage-meter.png?fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=4ac27cfb54b636aaffc7cecaca636c28" alt="The Identifications card on Usage in the analytics dashboard: billing cycle Sep 12 to Oct 12, 2026, 41% used, Used 61,240, Remaining 88,760, Included volume 150,000 / month, Usage resets on Oct 12, 2026." width="2238" height="484" data-path="images/dashboard/usage-meter.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/usage-meter-dark.png?fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=afbf80350d0ef77dd7aff493da997446" alt="The Identifications card on Usage in the analytics dashboard in the dark theme: billing cycle Sep 12 to Oct 12, 2026, 41% used, Used 61,240, Remaining 88,760, Included volume 150,000 / month, Usage resets on Oct 12, 2026." width="2238" height="484" data-path="images/dashboard/usage-meter-dark.png" />
</Frame>

## At your included volume

At your included volume, identification pauses and the identification request returns HTTP 402 until the billing cycle resets or you change plan. Usage shows a notice as you approach it and when you reach it, each with **Change plan**. The Free plan is 5,000 identifications, one time, so after they are used identification resumes when you move to a paid plan. See [Billing](/billing) and [Errors](/errors).

## Plans

In **Plans**, on **Monthly** billing, Starter is $99 a month with 25,000 identifications, Growth $399 with 150,000 and Scale \$999 with 500,000; **Yearly**, selected by default, saves 20%. Every plan includes the full detection stack. **Compare plans** opens a side-by-side table, and **Promo code** applies a code you received.

## Change plan

Select a plan's upgrade or downgrade button to open the plan change. It shows your current and new plan, what is due today and the next charge, as a preview from Stripe; the exact amount is confirmed at secure checkout. When the new plan includes fewer identifications than you already used this cycle, the dialog warns you. A downgrade charges nothing today and starts at the next renewal, when usage resets; the warning shows on a downgrade too, and only the identification request returns HTTP 402, at your current plan's included volume. **Continue to checkout** completes the change in Stripe.

<Frame caption="Changing plan in the analytics dashboard, with a Stripe preview of the amount.">
  <img className="block dark:hidden" src="https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/usage-plan-dialog.png?fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=ea09bf0d602532c37193d2663ea320d9" alt="The plan change dialog in the analytics dashboard, Downgrade to a lower plan from Growth to Starter: Due today $0.00, Next charge $99.00 monthly from Oct 12, 2026, the Secure checkout note, and the warning that this plan is smaller than current usage." width="1040" height="1118" data-path="images/dashboard/usage-plan-dialog.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/usage-plan-dialog-dark.png?fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=1dc33b7d6d23f6ccff8df94de09f3a48" alt="The plan change dialog in the analytics dashboard in the dark theme, Downgrade to a lower plan from Growth to Starter: Due today $0.00, Next charge $99.00 monthly from Oct 12, 2026, the Secure checkout note, and the warning that this plan is smaller than current usage." width="1040" height="1118" data-path="images/dashboard/usage-plan-dialog-dark.png" />
</Frame>

## Billing

**Settings > Billing**, from the account menu or the **Billing** link at the top of Usage, holds your **Plan**, **Price**, **Renews**, **Included volume**, **Payment method** and **Next payment**. **Manage in Stripe** updates your card, and **Invoice history** lists every invoice to download. **Cancel subscription** keeps access until the end of the current billing period, after which the account moves to Free; **Resume subscription** undoes it before then.

<Frame caption="Plan and payment method in the analytics dashboard settings.">
  <img className="block dark:hidden" src="https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/settings-billing.png?fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=f950227c3093791b81089120602a0c3a" alt="Settings > Billing in the analytics dashboard: Plan Growth, Price $399.00 Monthly, excl. VAT, Renews Oct 12, 2026, Included volume 150,000 / month, Payment method Visa ending 4242, Next payment $399.00, Manage in Stripe and Cancel subscription." data-og-width="2270" width="2270" data-og-height="864" height="864" data-path="images/dashboard/settings-billing.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/settings-billing.png?w=280&fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=9ae8eb3482cf995c6b54f6978fe382b2 280w, https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/settings-billing.png?w=560&fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=c09b5109fcd74b7199034de9a4f8dc4f 560w, https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/settings-billing.png?w=840&fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=9ca15ea1f41b5abb87a2a3bb4784df69 840w, https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/settings-billing.png?w=1100&fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=2273bdbbb1e2d0797058e4978c5798a9 1100w, https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/settings-billing.png?w=1650&fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=c27e9830e5f19704121a712ae91c382d 1650w, https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/settings-billing.png?w=2500&fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=92627ae101e39cff5ebb57a2fb0f0677 2500w" />

  <img className="hidden dark:block" src="https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/settings-billing-dark.png?fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=9e546cd9511040a8f31af56c560db68d" alt="Settings > Billing in the analytics dashboard in the dark theme: Plan Growth, Price $399.00 Monthly, excl. VAT, Renews Oct 12, 2026, Included volume 150,000 / month, Payment method Visa ending 4242, Next payment $399.00, Manage in Stripe and Cancel subscription." data-og-width="2270" width="2270" data-og-height="864" height="864" data-path="images/dashboard/settings-billing-dark.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/settings-billing-dark.png?w=280&fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=5f088aad750831c38eecb111cdd286a2 280w, https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/settings-billing-dark.png?w=560&fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=3666bf8f33d58f814ee856fdf4478b13 560w, https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/settings-billing-dark.png?w=840&fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=4537988b50d21295e09dac1ed4c85a74 840w, https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/settings-billing-dark.png?w=1100&fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=c986ba2f34b12fdcaeb417f9b8a36360 1100w, https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/settings-billing-dark.png?w=1650&fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=c6458c58c044eb056924f9f54af1eca8 1650w, https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/settings-billing-dark.png?w=2500&fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=ef08ac69873c46fa0ede52ba39f0453e 2500w" />
</Frame>

<Frame caption="Invoice history in the analytics dashboard settings.">
  <img className="block dark:hidden" src="https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/settings-invoices.png?fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=4630b29725a987e6a05a25f5dc9dd6a5" alt="Invoice history in the analytics dashboard settings: four paid Growth invoices of $399.00 for the cycles from Jun 12 to Oct 12, 2026, each with a download icon." width="1806" height="582" data-path="images/dashboard/settings-invoices.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/shieldlabs-725d18f1/JyleDzUFYU3SXP4Q/images/dashboard/settings-invoices-dark.png?fit=max&auto=format&n=JyleDzUFYU3SXP4Q&q=85&s=3d775d4c11deb87cf90157e8ad455cb6" alt="Invoice history in the analytics dashboard settings in the dark theme: four paid Growth invoices of $399.00 for the cycles from Jun 12 to Oct 12, 2026, each with a download icon." width="1806" height="582" data-path="images/dashboard/settings-invoices-dark.png" />
</Frame>

## Profile and security

**Settings > Profile** holds your name, your email (changed through a confirmation link) and your display timezone, which every date and time on every screen follows. **Settings > Security** changes your password.

## Next steps

<CardGroup cols={3}>
  <Card title="Billing" icon="credit-card" href="/billing">
    Plans, included identifications and billing cycles.
  </Card>

  <Card title="Optimizing usage" icon="sliders" href="/setup/optimizing-usage">
    Where to place calls so each identification counts.
  </Card>

  <Card title="Rate limits" icon="gauge-high" href="/rate-limits">
    Per-visitor and per-domain limits, and the frozen state.
  </Card>

  <Card title="Errors" icon="triangle-exclamation" href="/errors">
    HTTP 402 and the other statuses, by API.
  </Card>

  <Card title="Accounts and identifications" icon="layer-group" href="/concepts/accounts-and-identifications">
    The identification your plan counts, and the account behind it.
  </Card>

  <Card title="Domains" icon="globe" href="/setup/domains">
    One account quota shared by all your domains.
  </Card>
</CardGroup>
