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

# Manage your subscription

> Change your billing cadence, check your renewal date, resume a cancelled plan and open the billing portal from Settings, Plan and billing in TimeTracker.

Everything about a live subscription is on one screen: **Settings → Plan & billing**.

## What the page shows

Once a workspace is paying, the billing page shows a single **Pro plan** card:

| Line             | What it tells you                                          |
| ---------------- | ---------------------------------------------------------- |
| The status pill  | `active`, `past_due`, `paused` or `cancelled`              |
| The price figure | Your current amount, before tax, for your seat count       |
| **Seats**        | How many people you are billed for                         |
| **Renews**       | "Automatically, until you cancel"                          |
| **Access ends**  | Shown instead of **Renews** if a cancellation is scheduled |
| **Invoices**     | A pointer to the billing portal for receipts and your card |

The card mirrors what our payment provider has confirmed. It never guesses – if a change has been requested but not confirmed yet, the page keeps showing the old state until the confirmation lands.

## The controls

| Button                                       | What it does                                                     |
| -------------------------------------------- | ---------------------------------------------------------------- |
| **Manage billing**                           | Opens the billing portal in a new tab – card, invoices, receipts |
| **Switch to yearly** / **Switch to monthly** | Changes the cadence on your live subscription                    |
| **Cancel subscription**                      | Schedules cancellation at the end of the current period          |
| **Resume subscription**                      | Appears once a cancellation is scheduled, and undoes it          |

<Note>
  **Cancel** and **Switch** disappear once a cancellation is scheduled, and **Resume subscription** takes their place. There is only ever one sensible next action on the card.
</Note>

## Switch between monthly and yearly

<Steps>
  <Step title="Open Plan & billing">
    **Settings → Plan & billing**.
  </Step>

  <Step title="Click Switch to yearly or Switch to monthly">
    The button names the cadence you are switching **to**.
  </Step>

  <Step title="Read the timing">
    Switching **to yearly** applies right away, and what you have already paid is prorated. Switching **to monthly** takes effect at your next renewal date – nothing changes before then.
  </Step>

  <Step title="Confirm">
    The page shows "Plan change requested" and updates once the change is confirmed.
  </Step>
</Steps>

## Seats change on their own

You never buy or release a seat by hand.

* **Add someone** – invite a member, add one directly, or invite a client-portal contact – and the billed quantity goes up. An increase is prorated immediately.
* **Remove someone** and the billed quantity goes down at your **next renewal**, not mid-period.

The **Seats** line on the plan card is the number you are billed for. See [Seats](/billing/seats) for exactly who is counted.

## Example

Northwind Studio pays monthly for 12 seats.

1. In March, Tom invites Jonas. Seats go to 13, and the increase is prorated on the spot.
2. In April, Ana's contract ends and Tom removes her. Seats stay billed at 13 for the rest of the month and drop to 12 at the next renewal.
3. In May, Maya clicks **Switch to yearly**. It applies immediately and the months already paid for are prorated.

## Options and settings

| Setting         | Where                       | Effect                                       |
| --------------- | --------------------------- | -------------------------------------------- |
| Billing cadence | Plan & billing              | Monthly or yearly. Same features either way. |
| Payment method  | Billing portal              | The card charged at renewal                  |
| Billing email   | The workspace owner's email | Where receipts and payment notices go        |
| Seat count      | Automatic                   | Follows people with access                   |

<Note>
  Receipts and payment notices go to the **current owner** of the workspace. If you transfer ownership, they follow the new owner.
</Note>

## Permissions

| Action                                          | Capability       | Roles by default |
| ----------------------------------------------- | ---------------- | ---------------- |
| Open the billing page                           | `billing.manage` | Owner, Admin     |
| Switch cadence, cancel, resume, open the portal | `billing.manage` | Owner, Admin     |

If you do not hold `billing.manage`, the page reads "Only workspace owners and admins can change billing" and the buttons are not shown. `billing.manage` is a capability, so a custom role can be granted it – see [Roles and capabilities](/concepts/roles-and-capabilities).

## What happens next

* A cadence switch shows in the app once it is confirmed, not when you click.
* A seat change is reflected on your next invoice.
* Nothing about your data changes when you change cadence.

## Common questions

<AccordionGroup>
  <Accordion title="Where are my invoices?">
    In the billing portal, behind **Manage billing**. See [Payment methods and receipts](/billing/payment-methods-and-receipts).
  </Accordion>

  <Accordion title="I switched cadence but the page still shows the old one.">
    The page mirrors confirmed state. Give it a few seconds. If it has not changed after a minute, reload.
  </Accordion>

  <Accordion title="Can I set the seat count myself?">
    No. Seats follow the number of people with access, so the bill and the roster can never disagree.
  </Accordion>

  <Accordion title="I removed someone. Why is the price the same?">
    A decrease applies at your next renewal, not mid-period.
  </Accordion>

  <Accordion title="What does 'past due' mean?">
    A payment failed. You keep Pro features through a grace window while you fix the card. See [When a plan lapses](/billing/when-a-plan-lapses).
  </Accordion>

  <Accordion title="Can I pause a subscription?">
    A `paused` status can appear on the plan card, but pausing is done through the billing portal rather than the TimeTracker screen.
  </Accordion>
</AccordionGroup>

## Troubleshooting

| Problem                               | Cause                                      | Fix                                   |
| ------------------------------------- | ------------------------------------------ | ------------------------------------- |
| "We couldn't open the billing portal" | The portal did not load                    | Try again in a moment                 |
| "We couldn't change your plan"        | The request did not go through             | Try again, or open the billing portal |
| The buttons are missing               | You lack `billing.manage`                  | Ask an owner or admin                 |
| Seats look wrong                      | Open invitations and portal contacts count | See [Seats](/billing/seats)           |

## Related guides

<CardGroup cols={2}>
  <Card title="Payment methods and receipts" icon="receipt" href="/billing/payment-methods-and-receipts">
    Update a card, find an invoice.
  </Card>

  <Card title="Cancel or downgrade" icon="circle-minus" href="/billing/cancel-or-downgrade">
    End a subscription cleanly.
  </Card>

  <Card title="Seats" icon="users" href="/billing/seats">
    How the billed quantity is calculated.
  </Card>

  <Card title="When a plan lapses" icon="clock-rotate-left" href="/billing/when-a-plan-lapses">
    Trials, failed payments and grace windows.
  </Card>

  <Card title="Billing troubleshooting" icon="wrench" href="/billing/billing-troubleshooting">
    When something does not update.
  </Card>

  <Card title="Roles and capabilities" icon="shield" href="/concepts/roles-and-capabilities">
    Who holds `billing.manage`.
  </Card>
</CardGroup>