From 0405b31b26875b2bb8b3d935bfafb18f0b1c76f2 Mon Sep 17 00:00:00 2001
From: Nik Richers
Date: Fri, 2 Oct 2026 09:18:25 -0700
Subject: [PATCH] =?UTF-8?q?docs:=20re-publish=20Multigres=20Private=20Alph?=
=?UTF-8?q?a=20docs=20=E2=80=94=20merge=20on=20October=202,=202026=20(#506?=
=?UTF-8?q?64)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
## I have read the CONTRIBUTING.md file.
YES
## What kind of change does this PR introduce?
Re-add. Reapplies the Multigres Private Alpha docs section removed in
#50662, ready to merge once Sugu gives the go-ahead. Do not merge until
then.
Linear: MUL-1621 (follow-up to MUL-452).
## What is the current behavior?
Multigres docs section is down (per #50662): no overview/compatibility
pages, no sidebar entry, no features-table row, no "What you get" cards.
## What is the new behavior?
Exact reapply of #49020 (with Multigres marked Private Alpha): overview
guide at `/docs/guides/database/multigres`, compatibility stub, Database
sidebar entry, features-table row, "What you get" cards, and the
`ContentListings` optional-`href` support they rely on.
Base branch is the revert PR (#50662) so the diff here is legible now;
retarget to `master` once #50662 merges.
## Additional context
- `pnpm --filter docs exec vitest run lib/content-listings.test.ts` — 22
passed
- Blocked on Sugu's go-ahead — `do-not-merge` label applied
---------
Co-authored-by: Nik Richers
---
.../ContentListings.client.tsx | 64 ++++++----
.../NavigationMenu.constants.ts | 14 +++
.../content/guides/database/multigres.mdx | 60 ++++++++++
.../database/multigres/compatibility.mdx | 6 +
.../guides/getting-started/features.mdx | 111 +++++++++---------
.../data/content-listings/database.data.ts | 24 ++++
apps/docs/data/content-listings/index.ts | 3 +-
.../markdown-schema/ContentListings.ts | 5 +
apps/docs/lib/content-listings.test.ts | 39 +++++-
apps/docs/lib/content-listings.zod.mjs | 2 +-
apps/docs/style-guide/WORD_LIST.md | 4 +
.../ProjectHome/HighAvailabilityBadge.tsx | 2 +-
12 files changed, 251 insertions(+), 83 deletions(-)
create mode 100644 apps/docs/content/guides/database/multigres.mdx
create mode 100644 apps/docs/content/guides/database/multigres/compatibility.mdx
diff --git a/apps/docs/components/ContentListings/ContentListings.client.tsx b/apps/docs/components/ContentListings/ContentListings.client.tsx
index 93086bd588a..b28e1b18841 100644
--- a/apps/docs/components/ContentListings/ContentListings.client.tsx
+++ b/apps/docs/components/ContentListings/ContentListings.client.tsx
@@ -29,6 +29,8 @@ function useContentListingClickHandler(group: ContentListingGroup) {
const trackClick = useCallback(
(item: ContentListingItem) => {
+ if (!item.href) return
+
sendTelemetryEvent({
action: 'docs_content_listing_clicked',
properties: {
@@ -73,8 +75,45 @@ function ContentListingsGroup({ group }: { group: ContentListingGroup }) {
)}
{items.map((item) => {
+ const key = `${group.id}-${item.href ?? item.title}`
+ const panel = (
+ {item.badge}
+ ) : undefined
+ }
+ >
+ {item.badge && item.badgePosition === 'below' && (
+
+ {item.badge}
+
+ )}
+ {item.subtitle && (
+ {item.subtitle}
+ )}
+ {item.description}
+
+ )
+ const listContent = (
+ <>
+ {item.title}: {item.description}
+ >
+ )
+
+ if (!item.href) {
+ return (
+ -
+ {isGrid ? panel : listContent}
+
+ )
+ }
+
const external = isExternalContentListingHref(item.href)
- const key = `${group.id}-${item.href}`
if (isGrid) {
return (
@@ -87,26 +126,7 @@ function ContentListingsGroup({ group }: { group: ContentListingGroup }) {
target={external ? '_blank' : undefined}
rel={external ? 'noopener noreferrer' : undefined}
>
- {item.badge}
- ) : undefined
- }
- >
- {item.badge && item.badgePosition === 'below' && (
-
- {item.badge}
-
- )}
- {item.subtitle && (
- {item.subtitle}
- )}
- {item.description}
-
+ {panel}
)
@@ -120,7 +140,7 @@ function ContentListingsGroup({ group }: { group: ContentListingGroup }) {
target={external ? '_blank' : undefined}
rel={external ? 'noopener noreferrer' : undefined}
>
- {item.title}: {item.description}
+ {listContent}
)
diff --git a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
index 7898f39f534..17022d54b9b 100644
--- a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
+++ b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
@@ -1139,6 +1139,20 @@ export const database: NavMenuConstant = {
},
],
},
+ {
+ name: 'Multigres',
+ url: undefined,
+ items: [
+ {
+ name: 'Overview',
+ url: '/guides/database/multigres' as `/${string}`,
+ },
+ {
+ name: 'Compatibility',
+ url: '/guides/database/multigres/compatibility' as `/${string}`,
+ },
+ ],
+ },
{
name: 'Access and security',
url: undefined,
diff --git a/apps/docs/content/guides/database/multigres.mdx b/apps/docs/content/guides/database/multigres.mdx
new file mode 100644
index 00000000000..3100f911fbf
--- /dev/null
+++ b/apps/docs/content/guides/database/multigres.mdx
@@ -0,0 +1,60 @@
+---
+id: 'multigres'
+title: 'Multigres'
+subtitle: 'Horizontally scalable Postgres for high availability'
+description: 'Run high availability Postgres across multiple nodes with automatic failover, using Multigres.'
+---
+
+
+
+Multigres is in [Private Alpha](/docs/guides/getting-started/features#feature-status). It's free during the Alpha for organizations on a paid plan, for up to two projects, but pricing may change once it leaves Alpha. It isn't covered by the [uptime SLA](/sla), and Supabase isn't targeting production or mission-critical workloads with it during this stage.
+
+
+
+Multigres gives your project high availability by running Postgres across multiple nodes instead of one, so reads and writes continue if a node fails. It is Supabase's integration of [Multigres](https://multigres.com), an open-source project that brings the same distributed-systems approach Vitess brought to MySQL to Postgres.
+
+
+
+## Eligibility
+
+During the Private Alpha:
+
+- Multigres is available to organizations on a paid plan. It isn't available on the Free plan.
+- Availability is being rolled out gradually, so the option to enable it may not yet appear for every eligible organization.
+- Up to two projects per eligible organization can use Multigres for free during the Alpha.
+
+## Enabling Multigres
+
+In the Dashboard, Multigres appears as **High availability** during project creation:
+
+1. Open [Create a new project](/dashboard/new/_) in the Dashboard.
+2. Under **High availability**, turn on **Enable high availability**.
+3. Finish the remaining fields such as database password, region, and compute size, if shown.
+4. Click **Create new project**.
+
+If your organization isn't eligible or hasn't been rolled out yet, **High availability** won't appear.
+
+## What's not included in the alpha
+
+Some Supabase features and project operations aren't yet available on Multigres-backed projects:
+
+- **Realtime.** Multigres doesn't yet support the logical replication that Realtime depends on, so Realtime is unavailable.
+- **Point-in-Time Recovery.** Only the standard daily backups are available.
+- **Cross-region read replicas.** Multigres projects run in a single region during the Alpha.
+- **OrioleDB.** A project can use Multigres or [OrioleDB](/docs/guides/database/orioledb), not both.
+- **Resizing after creation.** Compute size, disk, and the number of replicas can't be changed after a Multigres project is created.
+- **Sharding and custom durability policies.** These are on the longer-term roadmap but aren't part of the Alpha.
+
+
+
+Enabling Multigres migrates your project's database to run on Multigres. There's currently no managed path to move it back to a standard Postgres project.
+
+
+
+## Compatibility
+
+Multigres aims for full compatibility with standard Postgres, but there are some differences to be aware of. See [Multigres compatibility](/docs/guides/database/multigres/compatibility) for details.
+
+## Resources
+
+[Multigres documentation](https://multigres.com/docs) — architecture, self-hosted deployment, and other technical depth that goes beyond the hosted Supabase integration covered on this page.
diff --git a/apps/docs/content/guides/database/multigres/compatibility.mdx b/apps/docs/content/guides/database/multigres/compatibility.mdx
new file mode 100644
index 00000000000..75f1f1deac3
--- /dev/null
+++ b/apps/docs/content/guides/database/multigres/compatibility.mdx
@@ -0,0 +1,6 @@
+---
+title: 'Multigres compatibility'
+description: 'Where Multigres-backed Postgres projects differ from standard Postgres.'
+---
+
+Multigres targets full compatibility with standard Postgres, verified against the [`pg_regress`](https://www.postgresql.org/docs/current/regress.html) test suite. See the [Multigres documentation](https://multigres.com/docs) for lower-level architecture and compatibility details, and the [Multigres overview](/docs/guides/database/multigres#whats-not-included-in-the-alpha) for what's not yet supported during the Private Alpha.
diff --git a/apps/docs/content/guides/getting-started/features.mdx b/apps/docs/content/guides/getting-started/features.mdx
index ed3054170aa..77d13dadc2e 100644
--- a/apps/docs/content/guides/getting-started/features.mdx
+++ b/apps/docs/content/guides/getting-started/features.mdx
@@ -199,61 +199,62 @@ Features in Beta are tested by an external penetration tester for security issue
In addition to the Beta requirements, features in GA are covered by the [uptime SLA](/sla).
-| Product | Feature | Stage | Available on self-hosted |
-| -------------- | -------------------------- | -------------- | ------------------------------------------- |
-| Database | Postgres | `GA` | ✅ |
-| Database | Vector Database | `GA` | ✅ |
-| Database | Auto-generated Rest API | `GA` | ✅ |
-| Database | Auto-generated GraphQL API | `GA` | ✅ |
-| Database | Webhooks | `beta` | ✅ |
-| Database | Vault | `public alpha` | ✅ |
-| Database | Supabase Pipelines | `public alpha` | N/A |
-| Platform | | `GA` | ✅ |
-| Platform | Point-in-Time Recovery | `GA` | 🚧 [wal-g](https://github.com/wal-g/wal-g) |
-| Platform | Custom Domains | `GA` | N/A |
-| Platform | Network Restrictions | `GA` | N/A |
-| Platform | SSL enforcement | `GA` | N/A |
-| Platform | Branching | `beta` | N/A |
-| Platform | Terraform Provider | `public alpha` | N/A |
-| Platform | Read Replicas | `GA` | N/A |
-| Platform | Log Drains | `public alpha` | ✅ |
-| Platform | MCP | `public alpha` | ✅ |
-| Platform | PrivateLink | `beta` | N/A |
-| Studio | | `GA` | ✅ |
-| Studio | SSO | `GA` | ✅ |
-| Studio | Column Privileges | `public alpha` | ✅ |
-| Realtime | Postgres Changes | `GA` | ✅ |
-| Realtime | Broadcast | `GA` | ✅ |
-| Realtime | Presence | `GA` | ✅ |
-| Realtime | Broadcast Authorization | `public beta` | ✅ |
-| Realtime | Presence Authorization | `public beta` | ✅ |
-| Realtime | Broadcast from Database | `public beta` | ✅ |
-| Storage | | `GA` | ✅ |
-| Storage | CDN | `GA` | 🚧 [Cloudflare](https://www.cloudflare.com) |
-| Storage | Smart CDN | `GA` | 🚧 [Cloudflare](https://www.cloudflare.com) |
-| Storage | Image Transformations | `GA` | ✅ |
-| Storage | Resumable Uploads | `GA` | ✅ |
-| Storage | S3 compatibility | `GA` | ✅ |
-| Edge Functions | | `GA` | ✅ |
-| Edge Functions | Regional Invocations | `GA` | ✅ |
-| Edge Functions | NPM compatibility | `GA` | ✅ |
-| Auth | | `GA` | ✅ |
-| Auth | Email sign-in | `GA` | ✅ |
-| Auth | Social login | `GA` | ✅ |
-| Auth | Phone sign-in | `GA` | ✅ |
-| Auth | Passwordless sign-in | `GA` | ✅ |
-| Auth | SSO with SAML | `GA` | ✅ |
-| Auth | Authorization via RLS | `GA` | ✅ |
-| Auth | CAPTCHA protection | `GA` | ✅ |
-| Auth | Server-side Auth | `beta` | ✅ |
-| Auth | Third-Party Auth | `GA` | ✅ |
-| Auth | Hooks | `beta` | ✅ |
-| CLI | | `GA` | ✅ Works with self-hosted |
-| Management API | | `GA` | N/A |
-| Client Library | JavaScript | `GA` | N/A |
-| Client Library | Flutter | `GA` | N/A |
-| Client Library | Swift | `GA` | N/A |
-| Client Library | Python | `beta` | N/A |
+| Product | Feature | Stage | Available on self-hosted |
+| -------------- | -------------------------- | --------------- | ------------------------------------------- |
+| Database | Postgres | `GA` | ✅ |
+| Database | Vector Database | `GA` | ✅ |
+| Database | Auto-generated Rest API | `GA` | ✅ |
+| Database | Auto-generated GraphQL API | `GA` | ✅ |
+| Database | Webhooks | `beta` | ✅ |
+| Database | Vault | `public alpha` | ✅ |
+| Database | Supabase Pipelines | `public alpha` | N/A |
+| Database | Multigres | `private alpha` | N/A |
+| Platform | | `GA` | ✅ |
+| Platform | Point-in-Time Recovery | `GA` | 🚧 [wal-g](https://github.com/wal-g/wal-g) |
+| Platform | Custom Domains | `GA` | N/A |
+| Platform | Network Restrictions | `GA` | N/A |
+| Platform | SSL enforcement | `GA` | N/A |
+| Platform | Branching | `beta` | N/A |
+| Platform | Terraform Provider | `public alpha` | N/A |
+| Platform | Read Replicas | `GA` | N/A |
+| Platform | Log Drains | `public alpha` | ✅ |
+| Platform | MCP | `public alpha` | ✅ |
+| Platform | PrivateLink | `beta` | N/A |
+| Studio | | `GA` | ✅ |
+| Studio | SSO | `GA` | ✅ |
+| Studio | Column Privileges | `public alpha` | ✅ |
+| Realtime | Postgres Changes | `GA` | ✅ |
+| Realtime | Broadcast | `GA` | ✅ |
+| Realtime | Presence | `GA` | ✅ |
+| Realtime | Broadcast Authorization | `public beta` | ✅ |
+| Realtime | Presence Authorization | `public beta` | ✅ |
+| Realtime | Broadcast from Database | `public beta` | ✅ |
+| Storage | | `GA` | ✅ |
+| Storage | CDN | `GA` | 🚧 [Cloudflare](https://www.cloudflare.com) |
+| Storage | Smart CDN | `GA` | 🚧 [Cloudflare](https://www.cloudflare.com) |
+| Storage | Image Transformations | `GA` | ✅ |
+| Storage | Resumable Uploads | `GA` | ✅ |
+| Storage | S3 compatibility | `GA` | ✅ |
+| Edge Functions | | `GA` | ✅ |
+| Edge Functions | Regional Invocations | `GA` | ✅ |
+| Edge Functions | NPM compatibility | `GA` | ✅ |
+| Auth | | `GA` | ✅ |
+| Auth | Email sign-in | `GA` | ✅ |
+| Auth | Social login | `GA` | ✅ |
+| Auth | Phone sign-in | `GA` | ✅ |
+| Auth | Passwordless sign-in | `GA` | ✅ |
+| Auth | SSO with SAML | `GA` | ✅ |
+| Auth | Authorization via RLS | `GA` | ✅ |
+| Auth | CAPTCHA protection | `GA` | ✅ |
+| Auth | Server-side Auth | `beta` | ✅ |
+| Auth | Third-Party Auth | `GA` | ✅ |
+| Auth | Hooks | `beta` | ✅ |
+| CLI | | `GA` | ✅ Works with self-hosted |
+| Management API | | `GA` | N/A |
+| Client Library | JavaScript | `GA` | N/A |
+| Client Library | Flutter | `GA` | N/A |
+| Client Library | Swift | `GA` | N/A |
+| Client Library | Python | `beta` | N/A |
- ✅ = Fully Available
- 🚧 = Available, but requires external tools or configuration
diff --git a/apps/docs/data/content-listings/database.data.ts b/apps/docs/data/content-listings/database.data.ts
index 60c9b4c038e..65cd98428f1 100644
--- a/apps/docs/data/content-listings/database.data.ts
+++ b/apps/docs/data/content-listings/database.data.ts
@@ -94,3 +94,27 @@ export const databaseNextSteps: ContentListingGroup = {
},
],
}
+
+export const databaseMultigresWhatYouGet: ContentListingGroup = {
+ id: 'database-multigres-what-you-get',
+ heading: 'What you get',
+ description:
+ 'When you enable Multigres on a project, your database runs as a small cluster instead of a single instance:',
+ type: 'grid',
+ items: [
+ {
+ title: 'Automatic failover',
+ description:
+ 'If a node fails, another in the cluster is promoted within seconds, without you having to intervene.',
+ },
+ {
+ title: 'No connection changes',
+ description:
+ 'Use the same connection string. Coordination is transparent to your application.',
+ },
+ {
+ title: 'Consensus-backed durability',
+ description: 'Writes are acknowledged only after the cluster agrees they are durable.',
+ },
+ ],
+}
diff --git a/apps/docs/data/content-listings/index.ts b/apps/docs/data/content-listings/index.ts
index b3aa5c13798..df2d27f335f 100644
--- a/apps/docs/data/content-listings/index.ts
+++ b/apps/docs/data/content-listings/index.ts
@@ -2,7 +2,7 @@ import type { ContentListingGroup } from '~/lib/content-listings.schema'
import { aiToolsBuildingIntoApp, aiToolsSupportedAgents } from './ai-tools.data'
import { authGetStarted, authNextSteps, authPricing } from './auth.data'
-import { databaseGetStarted, databaseNextSteps } from './database.data'
+import { databaseGetStarted, databaseMultigresWhatYouGet, databaseNextSteps } from './database.data'
import {
functionsExamplesAiMedia,
functionsExamplesMessaging,
@@ -47,6 +47,7 @@ const ALL_GROUPS: readonly ContentListingGroup[] = [
authPricing,
authNextSteps,
databaseGetStarted,
+ databaseMultigresWhatYouGet,
databaseNextSteps,
functionsGetStarted,
functionsExamplesSupabase,
diff --git a/apps/docs/internals/markdown-schema/ContentListings.ts b/apps/docs/internals/markdown-schema/ContentListings.ts
index 6817ce1f919..56b1c7ba404 100644
--- a/apps/docs/internals/markdown-schema/ContentListings.ts
+++ b/apps/docs/internals/markdown-schema/ContentListings.ts
@@ -34,6 +34,11 @@ export function serializeContentListingGroupToMarkdown(
}
for (const item of items) {
+ if (!item.href) {
+ lines.push(`- **${item.title}:** ${item.description}`)
+ continue
+ }
+
const href = isExternalContentListingHref(item.href)
? item.href
: `${linkBaseUrl}${withDocsBasePath(item.href)}`
diff --git a/apps/docs/lib/content-listings.test.ts b/apps/docs/lib/content-listings.test.ts
index cd3166285cf..1eeb4059884 100644
--- a/apps/docs/lib/content-listings.test.ts
+++ b/apps/docs/lib/content-listings.test.ts
@@ -147,6 +147,27 @@ describe('serializeContentListingGroupToMarkdown', () => {
)
})
+ it('renders items without href as unlinked list entries', () => {
+ const markdown = serializeContentListingGroupToMarkdown(
+ {
+ id: 'what-you-get',
+ heading: 'What you get',
+ items: [
+ {
+ title: 'Automatic failover',
+ description: 'Another node is promoted if a node goes down.',
+ },
+ ],
+ },
+ 'https://supabase.com'
+ )
+
+ expect(markdown).toContain(
+ '- **Automatic failover:** Another node is promoted if a node goes down.'
+ )
+ expect(markdown).not.toContain('](')
+ })
+
it('omits heading line when heading is not set', () => {
const markdown = serializeContentListingGroupToMarkdown(
{
@@ -260,9 +281,11 @@ describe('dashboard content listing hrefs', () => {
// Root-relative /dashboard hrefs get the docs basePath and 404; use absolute URLs.
it('uses absolute https://supabase.com dashboard URLs', () => {
const dashboardLinks = Object.values(CONTENT_LISTINGS).flatMap((group) =>
- group.items
- .filter((item) => isDashboardHref(item.href))
- .map((item) => ({ listingId: group.id, title: item.title, href: item.href }))
+ group.items.flatMap((item) =>
+ item.href && isDashboardHref(item.href)
+ ? [{ listingId: group.id, title: item.title, href: item.href }]
+ : []
+ )
)
expect(dashboardLinks.length).toBeGreaterThan(0)
@@ -275,6 +298,16 @@ describe('dashboard content listing hrefs', () => {
})
})
+describe('contentListingItemSchema href', () => {
+ it('accepts an item without href', () => {
+ const result = contentListingItemSchema.safeParse({
+ title: 'Automatic failover',
+ description: 'Another node is promoted if a node goes down.',
+ })
+ expect(result.success).toBe(true)
+ })
+})
+
describe('contentListingItemSchema icon', () => {
const baseItem = {
title: 'Datadog',
diff --git a/apps/docs/lib/content-listings.zod.mjs b/apps/docs/lib/content-listings.zod.mjs
index decf8220a03..bc9b6de5e2d 100644
--- a/apps/docs/lib/content-listings.zod.mjs
+++ b/apps/docs/lib/content-listings.zod.mjs
@@ -22,7 +22,7 @@ export const contentListingIconSchema = z.union([z.string().min(1), contentListi
export const contentListingItemSchema = z.object({
title: z.string().min(1),
- href: z.string().min(1),
+ href: z.string().min(1).optional(),
description: z.string().min(1),
/** Shown under the title on grid cards, before the description. */
subtitle: z.string().min(1).optional(),
diff --git a/apps/docs/style-guide/WORD_LIST.md b/apps/docs/style-guide/WORD_LIST.md
index ae05cb3ecf6..61470ca93bc 100644
--- a/apps/docs/style-guide/WORD_LIST.md
+++ b/apps/docs/style-guide/WORD_LIST.md
@@ -539,6 +539,10 @@ Write _microservices_, not _micro-services_.
Use _might_ for possibility or an uncertain outcome.
+### Multigres
+
+Use _Multigres_ for the product name. Don't write _multi-gres_ or _MultiGres_.
+
### must
Use _must_ or _need to_ for a requirement. Don't use _must_ for a recommendation.
diff --git a/apps/studio/components/interfaces/ProjectHome/HighAvailabilityBadge.tsx b/apps/studio/components/interfaces/ProjectHome/HighAvailabilityBadge.tsx
index 15041a5c3c5..b1b45f29756 100644
--- a/apps/studio/components/interfaces/ProjectHome/HighAvailabilityBadge.tsx
+++ b/apps/studio/components/interfaces/ProjectHome/HighAvailabilityBadge.tsx
@@ -37,7 +37,7 @@ export function HighAvailabilityBadge({ size = 'default' }: HighAvailabilityBadg
globally distributed deployments.