# Update Plan Card
URL: /docs/components/update-plan/update-plan-card

The Update Plan Card component provides a compact, card-based interface for users to upgrade or change their subscription plan. It's perfect for embedding in dashboards or sidebars where space is limited.

***

title: Update Plan Card
description: The Update Plan Card component provides a compact, card-based interface for users to upgrade or change their subscription plan. It's perfect for embedding in dashboards or sidebars where space is limited.
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

<Tabs items={['Preview', 'Code']} className="bg-transparent border-none">
  <Tab value="Preview" className="border-none bg-transparent p-0 mt-3">
    <PreviewComponents registryName="update-plan-card">
      <UpdatePlanCardDemo />
    </PreviewComponents>
  </Tab>

  <Tab value="Code" className="mt-3">
    ```tsx title="src/components/update-plan-card-demo.tsx"
    "use client";

    import { UpdatePlanCard } from "@/components/billingsdk/update-plan-card";
    import { plans } from "@/lib/billingsdk-config";

    export function UpdatePlanCardDemo() {
      return (
        <main className="flex w-full flex-1 flex-col justify-center text-center">
          <UpdatePlanCard
            currentPlan={plans[0]}
            plans={plans}
            onPlanChange={(planId) => {
              console.log("Upgrade plan to", planId);
            }}
          />
        </main>
      );
    }

    ```
  </Tab>
</Tabs>

## Installation

<Tabs items={['shadcn', 'billingSDK']} defaultValue="shadcn" className="bg-transparent border-none">
  <Tab value="shadcn" className="border-none bg-transparent p-0 mt-3">
    <Tabs items={['npx', 'pnpm', 'yarn', 'bun']} defaultValue="npx" groupId="installation-tabs">
      <Tab value="npx">
        ```bash
        npx shadcn@latest add @billingsdk/update-plan-card
        ```
      </Tab>

      <Tab value="pnpm">
        ```bash
        pnpm dlx shadcn@latest add @billingsdk/update-plan-card
        ```
      </Tab>

      <Tab value="yarn">
        ```bash
        yarn dlx shadcn@latest add @billingsdk/update-plan-card
        ```
      </Tab>

      <Tab value="bun">
        ```bash
        bunx shadcn@latest add @billingsdk/update-plan-card
        ```
      </Tab>
    </Tabs>
  </Tab>

  <Tab value="billingSDK" className="border-none bg-transparent p-0 mt-3">
    <Tabs items={['npx', 'pnpm', 'yarn', 'bun']} defaultValue="npx" groupId="billingsdk-cli-tabs">
      <Tab value="npx">
        ```bash
        npx @billingsdk/cli add update-plan-card
        ```
      </Tab>

      <Tab value="pnpm">
        ```bash
        pnpm dlx @billingsdk/cli add update-plan-card
        ```
      </Tab>

      <Tab value="yarn">
        ```bash
        yarn dlx @billingsdk/cli add update-plan-card
        ```
      </Tab>

      <Tab value="bun">
        ```bash
        bunx @billingsdk/cli add update-plan-card
        ```
      </Tab>
    </Tabs>
  </Tab>
</Tabs>

## Usage

```tsx
import { UpdatePlanCard } from "@/components/billingsdk/update-plan-card";
import { plans } from "@/lib/billingsdk-config";
```

```tsx
<UpdatePlanCard
  currentPlan={plans[0]}
  plans={plans}
  onPlanChange={(planId) => {
    // Handle plan change
    console.log('Plan changed to:', planId);
  }}
  title="Upgrade Your Plan"
/>
```

## Props

| Prop           | Type                       | Required | Description                                         |
| -------------- | -------------------------- | -------- | --------------------------------------------------- |
| `currentPlan`  | `Plan`                     | ✅        | The user's current plan object                      |
| `plans`        | `Plan[]`                   | ✅        | Array of available plans to choose from             |
| `onPlanChange` | `(planId: string) => void` | ✅        | Callback function when a plan is selected           |
| `className`    | `string`                   | ❌        | Additional CSS classes for styling                  |
| `title`        | `string`                   | ❌        | Custom title for the card (default: "Upgrade Plan") |

## Theming

The update plan card component is styled using the `shadcn/ui` library. You can customize the colors and fonts by overriding the CSS variables. You can also get the theme from the [Theming](/docs/theming) page.

## Example

```tsx title="src/components/update-plan-card-demo.tsx"
"use client";

import { UpdatePlanCard } from "@/components/billingsdk/update-plan-card";
import { plans } from "@/lib/billingsdk-config";

export function UpdatePlanCardDemo() {
  return (
    <main className="flex w-full flex-1 flex-col justify-center text-center">
      <UpdatePlanCard
        currentPlan={plans[0]}
        plans={plans}
        onPlanChange={(planId) => {
          console.log("Upgrade plan to", planId);
        }}
      />
    </main>
  );
}

```