Skip to content

add new billing page - #147

Open
alexcasalboni wants to merge 12 commits into
mainfrom
new-billing-page
Open

alexcasalboni wants to merge 12 commits into
mainfrom
new-billing-page

Conversation

@alexcasalboni

@alexcasalboni alexcasalboni commented Sep 2, 2026

Copy link
Copy Markdown
Collaborator

Context for why we need this new page: https://www.growthunhinged.com/p/ai-pricing-visibility-data

TL;DR: Our docs have no billing content. Buyers increasingly ask AI assistants what Unleash costs, and with nothing published, the answers get assembled from Reddit, Vendr, and competitor comparison pages instead. Competitors are currently the top result for "Unleash pricing" and are making claims we've never responded to.

The only risk I see is that we need to keep this page updated if/when the pricing model changes. But that doesn't happen too often :)

Before merging, I'd suggest we get an in-depth review from leadership.

@alexcasalboni alexcasalboni self-assigned this Sep 2, 2026
@github-actions

github-actions Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

🌿 Preview your docs: https://unleash-preview-new-billing-page.docs.buildwithfern.com

Here are the markdown pages you've updated:

Copilot AI left a comment

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.

🟡 Changes recommended

The new page contains internal contradictions (seat minimums) and publishes specific quantitative claims that are explicitly marked as unverified/possibly unapproved.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Adds a new “Plans and billing” support page to explain Unleash pricing/billing concepts (seats, API traffic allowances/overages, retention, add-ons, self-hosted considerations) and wires it into the Fern navigation under “Support and community”.

Changes:

  • Introduce a new billing documentation page with tables and FAQs covering plan-level billing details.
  • Add the new page to fern/docs.yml so it appears in the Support navigation.
File summaries
File Description
fern/pages/support/billing.mdx New billing/pricing explainer page with plan overview, metering details, retention, add-ons, and FAQs.
fern/docs.yml Adds “Plans and billing” to the Support and community navigation.
Review details

Suppressed comments (3)

fern/pages/support/billing.mdx:133

  • This section publishes specific self-hosting total-cost figures while the embedded TODO notes they may not yet be approved for public docs. Consider removing the specific numbers (and the TODO) until the figures are cleared, and keep the guidance qualitative.
Self-hosting removes the Unleash Cloud API traffic allowance, because traffic goes to your own servers. It does not remove the cost of running the service. Operating a highly available Unleash installation to a 99.99% target typically costs \$50,000 to \$200,000 per year in infrastructure and engineering time, and each additional Edge location adds roughly $15,000 per year. Compare that against the per-seat cost of Unleash Cloud when choosing a deployment model.

{/* TODO: Verify these TCO figures are approved for public documentation. They are in the
    internal messaging guide (facts.md) but this would be their first appearance in public docs.
    They are genuinely useful for the build-vs-buy comparison, so worth clearing rather than

fern/pages/support/billing.mdx:37

  • This paragraph says Enterprise bills on only two dimensions, but the same page later describes Enterprise add-ons and support tiers priced separately. Consider rewording to cover all paid plans and clarify that seats and API traffic are the only usage-metered dimensions, while add-ons/support can add fixed fees.
Unleash Enterprise bills on two dimensions only: **seats** and, on Unleash Cloud, **API traffic above the included allowance**. Nothing else is metered.

fern/pages/support/billing.mdx:71

  • This worked example includes specific request-volume numbers while the adjacent TODO indicates the billable-unit assumptions aren’t confirmed yet. To avoid publishing potentially incorrect calculations, consider replacing this with a generic estimation formula until finance/product confirms what counts toward the allowance.
**Worked example.** 200 backend SDK instances polling at the 15-second default make 4 requests per minute each, or about 173,000 requests per instance per month. Across 200 instances that is approximately 34.6 million requests per month, within the included 53 million allowance. Doubling the poll interval to 30 seconds halves it.

{/* TODO: Confirm the billable unit before publishing the worked example. Specifically:
      - Do metrics posts (POST /api/client/metrics) count toward the allowance?
      - Does traffic between Unleash Edge and the upstream server count, or only client-to-Edge?
  • Files reviewed: 2/2 changed files
  • Comments generated: 1
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines +21 to +23
| Contract term | None | Monthly, no commitment | Annual |
| Seat minimum | None | 5 seats for self-hosted | Agreed in contract |
| Included API traffic | Not applicable | 53 million requests per month (Cloud) | Agreed in contract |
Comment thread fern/pages/support/billing.mdx Outdated

A seat is a user account in your Unleash instance. Seats are billed at a flat monthly rate per seat, so your cost is a function of how many people have access, not how much they use Unleash.

{/* TODO: This section needs product and finance sign-off on the following, all of which are

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

I am not sure about these doubts. I think we need to run it through Seb or Nick.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

+1 for asking CS, but I remember to almost always answer 1st and 3rd on a few calls with prospects.


**Worked example.** 200 backend SDK instances polling at the 15-second default make 4 requests per minute each, or about 173,000 requests per instance per month. Across 200 instances that is approximately 34.6 million requests per month, within the included 53 million allowance. Doubling the poll interval to 30 seconds halves it.

{/* TODO: Confirm the billable unit before publishing the worked example. Specifically:

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Same here - we need explicit confirmation from engineering/CS.

Comment thread fern/pages/support/billing.mdx Outdated
| [Login history](/concepts/login-history) | Not available | Available | Available |
</StickyTable>

{/* TODO: Confirm audit log retention on Pay-As-You-Go. /pricing lists "Audit logs with up to

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

I'd tend to trust the doc page here :) Let's verify and then update the /pricing page accordingly.


Real-time streaming via Enterprise Edge is currently in early access.

{/* TODO: Add-on pricing is not published. Either state the pricing model for each (flat fee,

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Are we open to publishing this kind of info? If not, we can just say that it's quoted per contract.

@ivarconr ivarconr Sep 7, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Its quoted per customer, as it it usually a tailor-fit for their exact needs. Its only top 10% of customers that require these, and it normally comes up after they have validated that unleash is a fit for them.

Comment thread fern/pages/support/billing.mdx Outdated
Comment thread fern/pages/support/billing.mdx Outdated
Comment thread fern/pages/support/billing.mdx Outdated
Comment thread fern/pages/support/billing.mdx Outdated
Comment thread fern/pages/support/billing.mdx Outdated
@@ -0,0 +1,179 @@
---
title: "Plans and billing"

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Please merge with the availability page and ensure that all links in the docs that reference plans like OSS and Enterprise link to the right place. Also a good time to remove Pro from the availability page

|---|---|---|---|
| [Feature flag metrics](/concepts/impact-metrics) | 90 days | 90 days | 90 days |
| [Audit log](/concepts/events#event-log) | Basic | Basic | Advanced, up to 2 years |
| [Login history](/concepts/login-history) | Not available | Available | Available |

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Add impact metrics

Comment thread fern/pages/support/billing.mdx Outdated
Comment thread fern/pages/support/billing.mdx Outdated
Comment thread fern/pages/support/billing.mdx Outdated
Comment thread fern/pages/support/billing.mdx Outdated
Comment thread fern/pages/support/billing.mdx Outdated
Comment thread fern/pages/support/billing.mdx Outdated
Comment thread fern/pages/support/billing.mdx Outdated
Comment thread fern/pages/support/billing.mdx Outdated
alexcasalboni and others added 4 commits September 7, 2026 10:06
Co-authored-by: Melinda Fekete <melinda.fekete@getunleash.io>
Co-authored-by: Melinda Fekete <melinda.fekete@getunleash.io>
Co-authored-by: Melinda Fekete <melinda.fekete@getunleash.io>
Comment thread fern/pages/support/billing.mdx Outdated

Your monthly request volume is therefore roughly the number of connected SDK instances multiplied by their poll frequency, plus periodic metrics posts.

**Worked example.** 200 backend SDK instances polling at the 15-second default make 4 requests per minute each, or about 173,000 requests per instance per month. Across 200 instances that is approximately 34.6 million requests per month, within the included 53 million allowance. Doubling the poll interval to 30 seconds halves it.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

should we also have an example showing the total number of connected backend instances possible with 53Million monthly request and call out that other platforms count these as "service connections"? Competitive platforms usually charge in the thousands per month for those numbers.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Done!

@afronski afronski left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Minor remarks from my end.

## Plans overview

<StickyTable>
| | Open Source | Pay-as-you-go | Enterprise |

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

After reviewing this table in the preview, I find it confusing that it includes both cloud-based and self-hosting perspectives.

IMHO, if we split earlier, since the decision about cloud vs. self-hosting is made earlier anyway, it will be simpler to understand.


A seat is a user account in your Unleash instance. Seats are billed at a flat monthly rate per seat, so your cost is a function of how many people have access, not how much they use Unleash.

{/* TODO: This section needs product and finance sign-off on the following, all of which are

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

+1 for asking CS, but I remember to almost always answer 1st and 3rd on a few calls with prospects.

Comment thread fern/pages/support/billing.mdx Outdated
…M requests, use 'beta' badge inline under Edge
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants