Skip to content

chore(billing): tighten usage-based billing copy #3520

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
adboio wants to merge 1 commit into
base: main
Choose a base branch
from
Open

chore(billing): tighten usage-based billing copy #3520

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion packages/core/src/billing/usageLimitContent.test.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ describe("usageLimitContent", () => {
subscribed: false,
});
expect(content.title).toBe("Unlock premium models");
expect(content.description).toContain("This model isn't");
expect(content.description).toContain("open-source model");
expect(content.actionLabel).toBe("Add payment method");
});

Expand Down
4 changes: 2 additions & 2 deletions packages/core/src/billing/usageLimitContent.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ export function usageLimitContent(args: {
return {
title: "Unlock premium models",
description:
"This model isn't included in the free tier. Add a payment method to your organization to unlock all models — you only pay for what you use. You can keep working now by switching to an included model.",
"To use this model, add a payment method to your account. Your first $20 of usage is on us each month - you only pay for what you use beyond that.\n\nOr, you can keep working now by switching to an open-source model.",
Comment thread
adboio marked this conversation as resolved.

@annikaschmid annikaschmid Jul 16, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

here I would also specify that "you" is "your organization"

@adboio adboio Jul 16, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

per slack thread - i had sorta-reverted this back to:

> This model isn't included in the free plan. Add a payment method to your organization to unlock all models — you only pay for what you use. You can keep working now by switching to an included model.

or, i can make this new copy clearer about the org, something like this?

> To use this model, add a payment method to your account. Your organization's first $20 of usage is on us each month - only pay for what you use beyond that.\n\nOr, keep working now by switching to an open-source model.

actionLabel: "Add payment method",
dismissLabel: "Not now",
};
Expand All @@ -30,7 +30,7 @@ export function usageLimitContent(args: {
title: "Free usage used up",
description: `Your organization has used up its included PostHog Code usage.${
resetLabel ? ` ${resetLabel}.` : ""
} Add a payment method to keep going — you only pay for what you use.`,
} Add a payment method to keep going.`,
actionLabel: "Add payment method",
dismissLabel: "Not now",
};
Expand Down
20 changes: 10 additions & 10 deletions packages/ui/src/features/billing/UsageBillingAnnouncementModal.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,29 +68,29 @@ export function UsageBillingAnnouncementModal() {
</Flex>
<Dialog.Description>
<Text className="text-sm">
Seat-based plans are gone — PostHog Code is now usage-based. You
only pay for what you use.
Seat-based plans are gone. PostHog Code is now usage-based.
</Text>
</Dialog.Description>
<Flex direction="column" gap="2" className="text-sm">
<Text color="gray">
• The first <Text weight="medium">$20</Text> of usage each month
is included.
• Every organization gets $20 of free usage per month. You only
pay for what you use beyond that.
</Text>
<Text color="gray">
• Premium models need a payment method; an open model stays free.
• Open-source models are available for everyone. To use frontier
models you'll need a card on file.
</Text>
<Text color="gray">
{spendLimitUsd != null ? (
<>
• Your organization's spend limit is{" "}
<Text weight="medium">{`${formatUsdAmount(spendLimitUsd)}/month`}</Text>{" "}
— adjust it any time in billing settings.
• Your organization's billing limit is{" "}
<Text weight="medium">{`${formatUsdAmount(spendLimitUsd)}/mo`}</Text>
, adjustable anytime in your settings.
</>
) : (
<>
• A default <Text weight="medium">$50/month</Text> spend limit
applies — adjust it any time in billing settings.
• There's a default <Text weight="medium">$50/mo</Text>{" "}
billing limit, adjustable anytime in your settings.
</>
)}
</Text>
Expand Down
2 changes: 1 addition & 1 deletion packages/ui/src/features/billing/UsageLimitModal.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ export function UsageLimitModal() {
<Dialog.Title className="mb-0">{content.title}</Dialog.Title>
</Flex>
<Dialog.Description>
<Text color="gray" className="text-sm">
<Text color="gray" className="whitespace-pre-line text-sm">
{content.description}
</Text>
</Dialog.Description>
Expand Down
4 changes: 2 additions & 2 deletions packages/ui/src/features/settings/sections/PlanUsageSettings.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -131,8 +131,8 @@ export function PlanUsageSettings() {
</Text>
<Text className="text-(--gray-11) text-sm">
{freeTier
? "Your organization's first $20 of usage each month is included, with access to open models. Add a payment method to unlock premium models — you only pay for what you use."
: "Your organization pays for PostHog Code usage at cost — no seats, no subscriptions. The first $20 each month is included."}
? "Your org's first $20 of usage each month is included, with access to open models. Add a payment method to unlock premium models, and only pay for what you use."
: "Your organization pays for PostHog Code usage at cost. The first $20 each month is included."}
</Text>
</Flex>
{subscribed && (
Expand Down
Loading