Skip to content
Latchkey home
Documentation menu

Managing your subscription

The Billing page, changing plans, adding seats, the Stripe customer portal for payment methods and invoices, and what each subscription status means.

In short

  1. The Billing page (owners/admins) shows plan, seats, repositories, upcoming charges, and runner usage.
  2. Change plan upgrades or downgrades a subscription in place, and during a card-less trial choosing Developer, Launch or Scale under Plans and pressing Confirm opens Stripe Checkout; Invoices & payment method opens the Stripe portal.
  3. Developer needs a workspace with one member.
  4. Past Due, Paused, and Canceled all block access until resolved; data is retained throughout.
app.latchkey.dev / acme / billing

The Billing page of the acme workspace on a Scale subscription. The bill reads Plan $49.00 plus Runner minutes and Extra seats, both zero, equals Estimated total $49.00, with the plan charged Nov 18 and the runner minutes Nov 1. Runner usage this calendar month shows free minutes 4,200 of 6,000 small-equivalent minutes, the size weights small 1×, medium 2×, large 4× and xlarge 8×, and minutes by runner size with each size's rate. Batches of jobs finish and the bar fills by weight; at 81% a notice says runners keep running past the allowance and further minutes meter at each size's rate. At 6,000 of 6,000 the bar passes the marker, the free minutes are marked used up, and the notice gives the estimated overage so far, starting at 15 cents for the last job's 15 large minutes. By the end, 4,800 minutes have run, counted as 7,080 small-equivalent minutes; the line under the meter reads 1,080 small-equivalent min past your free allowance, and 675 minutes are billed for $2.70, and the bill reads $49.00 plus $2.70 plus zero for seats equals $51.70.

FIG. 6.2-AThe page reads as a bill: plan, plus runner minutes past the free allowance, plus extra seats, equals the estimated total. Watch the runner minutes term stay at zero until the free minutes run out, then carry the overage into the total.

Click Billing in the dashboard sidebar (owners and admins) to open the Billing page. Members see it as View only, with a note to contact the workspace owner or admin for changes.

What the page shows#

  • Estimated upcoming charges: the plan fee, runner minutes past the free allowance and extra seats, less any discount on your subscription, as an estimated total with the date each invoice is charged.
  • Repositories: monitored count against your plan limit.
  • Seats: seats in use against your limit, with any purchased extras marked.
  • Runners at once and Payment method: your concurrent runner cap and the card on file.
  • A Trial ends notice while trialing: the date the trial ends, the plan you are on until then, and that choosing a plan starts billing right away and ends any time left in your trial.
  • Runner usage this calendar month: a free-minute meter, this calendar month's minutes by runner size and billed past the free minutes, and the estimated runner cost so far.
  • Batch budgets: each batch of jobs that has a budget, with its budget, what its jobs have cost at list rates and who set it. An owner or admin can set, lower or raise a budget here. An API key can only set a first budget or lower one.
  • Spend limit: the most the workspace's runners may cost this calendar month, and what they have cost so far. An owner or admin sets, raises or removes it; at the limit Latchkey refuses new jobs, holds queued ones and stops running ones.
  • Recent invoices and Plans: up to three invoices once you have any, each with its date, status, amount and, where there is one, a PDF download, plus All invoices for owners and admins; and the plans, each with its estimate of your upcoming charges where one can be shown, which is where Change plan takes you.

The Runner usage this calendar month panel is the one worth a monthly glance: it is the live view of free-tier consumption and the runner cost accumulating this calendar month. The mechanics behind those numbers are covered in Runner usage and free minutes.

While trialing, a dashboard banner also reminds you to choose a plan before the trial ends, so your managed runners keep running without interruption, and tells owners and admins that choosing one starts billing right away and ends any time left in your trial; the page's trial notice tells you how long you have.

The actions#

  • Change plan upgrades or downgrades a subscription in place. During a card-less trial, choosing Developer, Launch or Scale under Plans and pressing Confirm opens Stripe Checkout instead, and the paid plan starts when you finish it. Downgrading below your monitored-repository count asks you to choose which repositories stay monitored. Downgrading to Developer requires the workspace to have only one member.
  • Manage seats adds or removes $5/month seats on every plan except Developer, with a live price preview before you press Update seats. It needs a Stripe subscription on file, so it stays disabled during a card-less trial.
  • Invoices & payment method opens the Stripe customer portal, where payment methods, invoices (with PDFs), and subscription details are managed securely by Stripe. It is disabled until the workspace has a Stripe customer, which happens when you first subscribe.
  • Contact support is on the page too, for anything the other buttons cannot fix.

Manage seats#

The Manage seats dialog (every plan except Developer) sets the new seat count with its Remove a seat and Add a seat buttons, and a live Price change preview shows exactly what the change costs before you press Update seats: the price per seat, the current monthly price, the new monthly price, and your next invoice with its date. You cannot reduce seats below your number of active members, so no change can orphan a teammate. No surprise charges either way: what you see in the preview is what Update seats applies.

Downgrading without surprises#

Upgrades are simple: pick the higher plan and the new limits apply. Downgrades have two rules worth knowing before you start, both enforced by the flow itself:

01
Check the repository count

Each plan caps monitored repositories (Developer 1, Launch 10, Scale 40). If you are above the target plan's cap, the downgrade asks you to choose which repositories stay monitored, so it is worth deciding which ones matter before you change the plan. See Managing repositories.

02
For Developer: get to one member

Downgrading to Developer requires the workspace to have only one member, because the plan has no team collaboration. Remove members from the Team page first; each removal frees the seat immediately.

03
Change the plan and verify

Use Change plan, then confirm the after-state on the same page: repositories against the new limit, seats in use, and the estimated total.

Subscription statuses and their effects#

StatusWhat it means for you
ActiveFull access.
TrialingFull access until the trial end date.
Past dueA payment failed. Dashboard and API access are blocked and runner launches stop until the payment method is fixed in the Stripe portal.
PausedThe subscription is paused. Dashboard and API access are blocked and runner launches stop until it is resumed.
CanceledThe subscription ended. Access is blocked, but billing remains reachable so you can re-subscribe; your data is retained.

The blocked states have different exits. Past due resolves through Stripe once the payment method is fixed; until then the workspace lands on the activation screen, and dashboard, API, and runner launches stay blocked. Contact support if you need the payment link. Paused clears when the subscription is resumed. Canceled keeps billing reachable on purpose, so you can re-subscribe whenever you choose; your data is retained while you decide.

Common questions#

Q.01Where do I see exactly what my next charge will be?

The Billing page shows it as the Estimated total: the estimate of your upcoming charges and the date each is charged, covering the plan, runner minutes, and any extra seats, less any discount on your subscription. Once an invoice is issued, the itemized version with a PDF lives in the Stripe customer portal, under Invoices & payment method.

Q.02I changed plans mid-cycle. What will I actually pay?

Check the Estimated total on the page right after the change: it shows your upcoming charges and the date of each, and a plan change moves only the plan's charge. The Stripe portal has the itemized invoice once it is issued.

Q.03Do runner minutes arrive on a separate bill?

Yes. Your plan is charged on its own invoice, when you subscribe and then each month on that date. Runner minutes past your free minutes are charged on a separate invoice on the 1st of each month (UTC), for the month just ended. In the month your workspace moves to separate bills, minutes run before the move are charged on the plan's next invoice. See Runner usage and free minutes.

Q.04What happens to my data if I cancel?

Your data is retained, and billing remains reachable so you can re-subscribe later. The destructive path is different and deliberate: deleting the workspace (Settings, Account; owner only) permanently removes its repositories, workflow data, and managed runner resources. Your GitHub repositories themselves are never affected.

Q.05Who can manage billing?

Owners and admins get the full Billing page; members see it as View only and are pointed to the workspace owner or admin for changes.