Commit Graph
22 Commits
Author SHA1 Message Date
Utkarash Kumar SinghandJoshen Lim 08c0fc247b feat(studio): warn about pg_graphql introspection change on upgrade (#46096)
<img width="1512" height="818" alt="introspection"
src="https://github.com/user-attachments/assets/5c0e4c6a-c0e9-496d-8768-4a55a2433268"
/>
## Summary

Adds an in-product admonition on the Infrastructure Settings page when a
project has pg_graphql < 1.6.0 installed, warning users that GraphQL
introspection will be disabled by default after upgrading. Links to
upgrade notes docs with the opt-in SQL.

The admonition is purely informational — it renders alongside the
upgrade button, does not block the upgrade.

## Context

pg_graphql 1.6.0 disables GraphQL introspection by default. The change
is upgrade-triggered (not backported), so users on 1.5.x will only
encounter it when their AMI bundles 1.6.0+. To prevent surprise breakage
of tools that rely on `__schema`/`__type` (GraphiQL, codegen, Relay
compiler, etc.), Studio surfaces this admonition before they upgrade.

Design discussion in
[PSQL-1199](https://linear.app/supabase/issue/PSQL-1199/prepare-dashboard-notification-for-pg-graphql-breaking-change).

## Companion PR

This depends on the schema change in
[supabase/platform#32954](https://github.com/supabase/platform/pull/32954)
which adds the new `warnings` field to
`ProjectUpgradeEligibilityResponse`.

## Admonition copy

- **Title:** \"GraphQL introspection will be disabled by default after
upgrade\"
- **Body:** \"After upgrading, queries to \`__schema\` and \`__type\`
will return an error unless introspection is explicitly re-enabled on
the schema. Regular data queries are not affected.\"
- **CTA:** \"Read upgrade notes\" → links to the new docs section


## Related

- Linear:
[PSQL-1199](https://linear.app/supabase/issue/PSQL-1199/prepare-dashboard-notification-for-pg-graphql-breaking-change)
- Parent rollout:
[PSQL-1163](https://linear.app/supabase/issue/PSQL-1163/breaking-change-pg-graphql-introspection-rollout)
- Companion platform PR: https://github.com/supabase/platform/pull/32954


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Documentation**
* Added “Upgrading to pg_graphql 1.6.0” and updated pg_graphql docs:
introspection is disabled by default, how to re-enable per schema,
verification steps, and affected tools.

* **New Features**
* Upgrade settings UI now shows validation warnings about introspection
with links to upgrade notes.

* **Chores**
* Added "GraphiQL" to MDX spelling allow list and added upgrade-warning
types to API surface.

<!-- review_stack_entry_start -->

[![Review Change
Stack](https://storage.googleapis.com/coderabbit_public_assets/review-stack-in-coderabbit-ui.svg)](https://app.coderabbit.ai/change-stack/supabase/supabase/pull/46096?utm_source=github_walkthrough&utm_medium=github&utm_campaign=change_stack)

<!-- review_stack_entry_end -->
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Joshen Lim <joshenlimek@gmail.com>
2026-05-19 15:42:44 +01:00
Tina Ha 5d02142004 docs: clarify pause and restore uses physical backup (#44580)
## I have read the
[CONTRIBUTING.md](https://github.com/supabase/supabase/blob/master/CONTRIBUTING.md)
file.

YES

## What kind of change does this PR introduce?

Docs update. This behaviour wasn't previously documented and causes
confusion for customers wondering what data state their project will be
restored to.

## Additional context

Ref slack (Paul at Infra Data):

https://supabase.slack.com/archives/C091448H1AM/p1767813291309359?thread_ts=1765466738731989&cid=C091448H1AM

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Documentation**
* Strengthened pause-and-restore guidance to explicitly state downtime
occurs during pausing.
* Updated pause wording to indicate users are redirected “in the
meantime” (removed explicit duration).
* Clarified restore is performed from a physical backup and that users
will receive an email when complete.
* Replaced detailed teardown caveat with a concise note: restoration
time depends on database size; contact support if it fails.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2026-04-07 11:09:21 -04:00
Jeremias Menichelli ac41f6bd6f chore: Remove unused ShowUntil (#43546) 2026-03-09 13:30:19 +01:00
Prashant SridharanandAlan Daniel 14d36e9480 Bolt webinar cta page (#43107)
## I have read the
[CONTRIBUTING.md](https://github.com/supabase/supabase/blob/master/CONTRIBUTING.md)
file.

YES

## What kind of change does this PR introduce?

New Go landing page for the upcoming Bolt webinar. This is where we will
direct customers who want to learn more to go to request a meeting.

---------

Co-authored-by: Alan Daniel <stylesshjs@gmail.com>
2026-02-24 10:50:54 +00:00
Jeremias Menichelli f6ec43a9ed [DOCS-454] fix(Docs): Fix images from causing CLS on pages (#43026) 2026-02-23 19:02:31 +01:00
Timothy LimandChris Chinchilla 93c2917c5b docs: Add link to restoring backup to new Supabase project (#39108)
Co-authored-by: Chris Chinchilla <chris.ward@supabase.io>
2025-12-11 11:42:25 +00:00
Ronan Lehane adad20a1a3 docs: Update upgrading.mdx (#41105)
I think the existing sentence may cause people to believe that they can access one-click restore if they upgrade to a paid plan outside the 90 day restore window - I do not believe this is accurate. 

I added the mention that if you upgrade within the 90 days period, they you may have one-click restore options
2025-12-09 15:18:19 +01:00
Danny White 73eca8ef5d feat: better Postgres 17 upgrade instructions for deprecated extensions (#38904)
* make section language consistent

minor style and language tweaks on Infrastructure page

* improved Postgres upgrade instructions

* fix: language

* add top border

for better scan-ability, since Manage button is far away from related text
2025-09-22 04:19:59 +00:00
CharisandChris Chinchilla 47705a8968 chore: replace all supabase urls with relative urls (#38537)
* fix: rewrite relative URLs when syncing to GitHub discussion

Relative URLs back to supabse.com won't work in GitHub discussions, so
rewrite them back to absolute URLs starting with https://supabase.com

* fix: replace all supabase urls with relative urls

* chore: add linting for relative urls

* chore: bump linter version

* Prettier

---------

Co-authored-by: Chris Chinchilla <chris.ward@supabase.io>
2025-09-09 12:54:33 +00:00
TheOtherBrian1 b540bb2f96 Update upgrading.mdx | added pgjwt to deprecation list (#37846)
Update upgrading.mdx
2025-08-12 18:03:08 +00:00
Charis e2fecc0f5d chore(docs linter): bump version (#36715)
* chore(docs linter): bump version

* style: format
2025-07-03 14:46:29 +00:00
Charis 6fcb98d927 docs(pg17): add docs on pg17 upgrades (#35431) 2025-05-22 14:07:06 -04:00
Inian c8a5c6736f fix(docs): update upgrading language (#35419) 2025-05-02 07:33:46 +00:00
Charis be99898efe docs: move restoring backup section (#35109)
Before:

Instructions for restoring a backup locally were buried inside the
Upgrading guide.

After:

Instructions for restoring a backup locally are on their own page in the
Local Development section. This page is linked from the Upgrading guide
because it is useful if a paused project has exceeded its restoring time
limit.
2025-04-18 12:30:33 +00:00
Div Arora fe1c18d177 fix: correct units for upgrade processing speed (#33523) 2025-03-13 15:21:33 +08:00
Han Qiao 1dc92a529d docs: update project restore docs for past 90 days backup (#32990)
* docs: update project restore docs for past 90 days backup

* chore: rephrase a few lines
2025-01-22 08:56:40 -06:00
PeterandCharis Lam 29117959b1 Docs: overhaul Migrating within Supabase page(#31049)
* Overhaul of Migrate within Supabase

* Added sub menus for overhaul of Migrate within supabase

* Re-structuring of content and pages

* Re-organize flow of the guide

* Prettier fix and small additions to dashboard restore guide

* update CLI guide to have dummy data for now

* Add structure for Windows specific instructions

* Add Postgres installation as partial

* Full first draft

* fix headings in main page

* Fix vale issues

* Proofread #1

* Small fixes

* Editing pass

* More edits after first tests.

* Final editting pass after testing

* Add common issues I ran into while testing and fixed installation instructions for MacOS

* Editing pass after more testing and proofreading

* Grammar fixes

* attempt at vale fixes

* Add tip for windows installation

* edits

* Fix dashboard restore hyperlink

---------

Co-authored-by: Charis Lam <26616127+charislam@users.noreply.github.com>
2025-01-06 07:11:53 -05:00
Charis d69902da94 chore(docs): lint all sections with linter v2 (#31110)
lint(docs): heading capitalization
2024-12-16 14:33:25 -05:00
Chris Gwilliams a496191122 Add warning about custom role passwords omitted in backups to relevant docs pages (#28760)
add note  on custom roles for backups
2024-11-20 09:12:12 +02:00
Oliver Rice 6b60d9d52b Minor Typo roject -> project (#30304)
typo roject -> project
2024-11-05 15:16:57 -05:00
Kevin Lu 837b424c72 docs: typo fix (#30065) 2024-10-24 09:41:34 +00:00
Charis 41d924b074 feat: new docs ia (#29364)
New Docs IA, mainly splitting up the miscellaneous bucket that is Platform into multiple sections
2024-10-09 12:38:34 -04:00