# Billing Settings block

> Billing settings page with plan summary, 3-column usage metrics, and invoice history table

Subscription billing settings page: trial alert, plan summary with renewal facts, 3-column usage metrics, billing detail rows with tooltip hints, and an invoice history table. Built with ReUI Alert, Badge, shadcn Card, Table, Field, Tooltip, Button.

- Type: Pro block
- Category: [Profile](https://web.dev.reui.io/blocks/application/profile.md)
- Page: https://web.dev.reui.io/blocks/application/profile/profile-8
- MCP: `get_block("profile-8")`
- Built with: Alert, Badge, Button, Card, Field, Item, Table, Tooltip
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

A blocked renewal alert above plan facts, 3 usage counters, a missing card badge in billing details and an invoice table with downloads

## Agent notes

- Replace the sample `PLAN_SUMMARY`, `PLAN_METRICS`, `BILLING_DETAILS` and `INVOICES`, and edit `TRIAL_NOTICE` for the alert copy
- No action Button in `Profile` or its cards has an `onClick`, so wire Add company card, Edit details, Download all and each invoice download
- Invoice references in `InvoiceHistoryCard` are links that call `preventDefault`, so point them at real invoice pages

## When not to use

- One customer account is reviewed with tabbed invoices, subscription and activity: use [Billing Account Detail](https://web.dev.reui.io/blocks/solutions/billing/solution-billing-4.md) (`get_block("solution-billing-4")`)
- An operator reviews many invoices and recovers past due balances: use [Invoice Ledger](https://web.dev.reui.io/blocks/solutions/billing/solution-billing-1.md) (`get_block("solution-billing-1")`)

## Install

```bash
npx shadcn@latest add @reui/profile-8
```

## About Profile blocks

### When to use

- Account areas that switch profile, workspace, team, billing or access panels from tabs or a sidebar
- A personal profile edit page: avatar, name, verified email, username, phone and regional preferences
- An account subpage for one job: sender mailboxes, alerts, referrals, meeting capture, billing or API keys

### When not to use

- One panel of switch rows or integration cards, with no personal identity fields: use the [Settings blocks](https://web.dev.reui.io/blocks/application/settings.md)
- Entering a new record, such as an invoice with line items or a product listing: use the [Form blocks](https://web.dev.reui.io/blocks/application/form.md)
- The outer navigation layout around every page of a product, beyond account pages: use the [App Shell blocks](https://web.dev.reui.io/blocks/application/app-shell.md)

### Agent notes

- Each page.tsx wraps `Profile` in its own padding and centering; render `Profile` alone inside your layout

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.
