Skip to content

Document global CPU/RAM reservations and 30% regional reservation blocks - #2665

Merged
asib merged 9 commits into
mainfrom
codex/5543-global-reservations-mintlify
Nov 20, 2026
Merged

asib merged 9 commits into
mainfrom
codex/5543-global-reservations-mintlify

Conversation

@asib

@asib asib commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

Summary of changes

Rewrites Machine reservation blocks in about/pricing.mdx to cover both kinds of reservation block, and moves regional blocks from 40% to 30% off. This PR now includes #2483's changes, so #2483 is closed.

The section now has three parts:

  • Machine reservation blocks: a table comparing regional and global blocks, then the rules both kinds share. Both are backdated to the 1st, give a monthly credit that doesn't roll over, cover only CPU and additional RAM, and are non-refundable. Regional credits always apply before global credits when both apply to a charge. Only admins buy reservations, and Linked Organizations buy them on the Billing Organization.
  • Regional: one CPU class in one region, paid upfront, now at 30% off. The six upfront prices change as shown below. The worked example is now $42 upfront, or $3.50/month, for $5/month of credit.
  • Global: any whole-dollar monthly credit from $100 to $50,000 for 12 months, at 20% off upfront or 10% off monthly. Larger amounts go to billing@fly.io, or to the support email address for organizations with a support plan. The price table shows the total credit, upfront price and monthly price for three example amounts.

Each subsection ends with buy steps that use the dashboard's labels.

Regional block Monthly credit Upfront (was) Upfront (now)
Shared $5 $36 $42
Shared $50 $360 $420
Shared $500 $3,600 $4,200
Performance $20 $144 $168
Performance $200 $1,440 $1,680
Performance $2,000 $14,400 $16,800

When to merge

Ready to merge. Both halves match production now:

  • superfly/ui-ex#5538 moved regional checkout, the calculator, /pricing.md and Billing's copy to 30%. It merged on 2026-11-20, and fly.io/pricing.md already shows the 30% prices.
  • superfly/ui-ex#6268 shipped global reservations on 2026-11-18, and the global-reservations flag is on for everyone.

Until this PR merges, the live pricing page still shows the 40% regional prices and no global section.

Anchors

  • #machine-reservation-blocks still opens the section. The Billing page's Learn More button, the regional checkout, the calculator and /pricing.md link there.
  • #global-cpuram-reservations is an explicit anchor on the Global subsection, because the global checkout and /pricing.md link to it.
  • #regional-reservation-blocks is a new explicit anchor on the Regional subsection.

All three resolve in the preview, and "On this page" lists Regional and Global under Machine reservation blocks.

Preview

Mintlify's PR preview

Related Fly.io community and GitHub links

Notes

Every figure and label was checked against ui-ex:

  • the global figures against Fly.SpendReservations.Offers and Pricing on main, and the regional prices against superfly/ui-ex#5538;
  • the button and field labels against the Billing reservation dialog, ReservationForm and GlobalReservationForm;
  • the payment behaviour against Fly.SpendReservations.Monthly.

Vale reports nothing on the page, and git diff --check passes.

Closes #2485
Closes superfly/ui-ex#5536

The regional changes were first prepared with GPT-6. The rest was written with Claude Opus 5.5.

🤖 Generated with Claude Code

asib and others added 4 commits September 15, 2026 18:05
Document the 30% discount, new upfront prices, unchanged monthly credits, and corrected shared reservation example.
The Mintlify cutover replaced about/pricing.html.markerb with
about/pricing.mdx. Drop the old file; the 30% reservation pricing moves
to the MDX page in the next commit.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Port the reservation changes from the old markerb page: a 30% discount,
upfront prices of $42/$420/$4,200 for shared and $168/$1,680/$16,800 for
performance, unchanged monthly credits, and a worked example at
$3.50/month.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Global reservations are live for every organization (superfly/ui-ex#6268).
Port the section from #2486 to the Mintlify page and match what shipped:
any whole-dollar monthly credit from $100 to $50,000, 20% off upfront or
10% off monthly for 12 months, payment-gated credit, Complete payment /
Retry payment / Try again, and the Billing page's Buy Reservations flow.
The explicit anchor keeps the #global-cpuram-reservations links from the
dashboard and /pricing.md working.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@asib
asib requested a review from a team as a code owner November 19, 2026 00:44
@asib asib added the feature label Nov 19, 2026
@mintlify

mintlify Bot commented Nov 19, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
fly-io 🟢 Ready View Preview Nov 20, 2026, 1:14 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

Conflict: main changed "organisation's" to "organization's" on the line
this branch changed to 30%. Keep both.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
asib and others added 3 commits November 20, 2026 00:49
Combines docs#2483 into this PR so that one PR covers both reservation
changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Both kinds are Machine reservation blocks, so the section now opens with
a table comparing them and the rules they share: backdating, no
rollover, CPU/RAM only, non-refundable, regional blocks used first, and
who buys them where. "Regional" and "Global" follow as subsections that
keep only what differs, each with its own buy steps.

The global subsection keeps its #global-cpuram-reservations anchor,
which ui-ex links to, and #machine-reservation-blocks still opens the
section.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@asib asib changed the title Document global CPU/RAM reservations Document global CPU/RAM reservations and 30% regional reservation blocks Nov 20, 2026
- Drop the list of products the credit doesn't cover.
- Say that regional credits always apply before global ones when both
  apply to a charge.
- Shorten the global intro, and offer support plan email addresses for
  larger reservations.
- Replace the global worked example with a "Total value of credit"
  column in the price table.
- Drop the paragraph on authenticating, retrying and failed payments.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@asib
asib merged commit 78bd220 into main Nov 20, 2026
1 check passed
@asib
asib deleted the codex/5543-global-reservations-mintlify branch November 20, 2026 01:19

This branch was successfully deployed

1 active deployment
staging — e376311c Deployed Nov 20, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document global CPU/RAM reservation commitments

1 participant