Staaarter

Billing Seat Usage Bar

A seat usage card for team billing screens. It shows how many seats are active and pending against the plan's total seat count, using a two-segment progress bar plus a plain-text breakdown, and turns amber once the team is at or near its limit. An optional Add seats button links out to a checkout or seat-management flow.

By Staaarter Team
Billing
Updated May 6, 2026
Docs
Live preview

Docs

Installation

A real shadcn registry command, not a copy-paste stand-in: it fetches this block plus its card, button dependencies and any missing npm packages, and installs them straight into your project.

npx shadcn add https://staaarter.com/r/billing-seat-usage-bar.json

Prefer not to use the CLI? Copy the source from the Code toggle above into src/components/blocks/billing/billing10.tsx instead.

Usage

The file also exports billing10Demo, the exact props behind the preview above. Spread it to get a working section in one line, then replace it with your own data.

import { Billing10, billing10Demo } from "@/components/blocks/billing/billing10";

export default function Page() {
  return <Billing10 {...billing10Demo} />;
}

Props

PropTypeDefaultDescription
titlestring"Team seats"Heading shown above the usage bar.
descriptionstringnoneOptional one-line note under the heading, for example the plan name.
activeSeatsnumbernoneCount of seats occupied by active members.
pendingSeatsnumber0Count of seats reserved by pending invitations, shown as a separate progress-bar segment.
totalSeatsnumbernoneThe plan's total seat limit, used as the denominator for the bar and the label.
addSeatsLabelstring"Add seats"Label for the footer button.
addSeatsHrefstringnoneDestination for the Add seats button; the button and footer are omitted entirely if this is not set.
classNamestringnoneExtra classes for the outer card.

Behavior notes

  • The bar has two stacked segments: active seats first, then pending seats in a muted color, so admins can tell reserved-but-unfilled capacity apart from occupied seats.
  • The active segment turns amber once activeSeats + pendingSeats reaches 90% or more of totalSeats, and a warning line appears once the team is fully at its limit.
  • The progress bar carries role="progressbar" with matching aria-value attributes, and the seat counts are also rendered as plain text so the state doesn't depend on the bar alone.
  • The Add seats button and its footer are only rendered when addSeatsHref is provided, so the block also works as a read-only summary with no action.
  • "Seats available" is computed as totalSeats minus active and pending seats combined, clamped at 0 so it never goes negative once the team is over capacity.

Frequently asked questions