Aaron ByrneandClaude 47b8660d8d docs(troubleshooting): troubleshooting guide so users can amend their failed migrations (#48257) ...

## 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?

Troubleshooting guide

## What is the current behavior?

NA
## What is the new behavior?

Troubleshooting guide
## Additional context

Add any other context or screenshots.


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

* **Documentation**
* Added a new troubleshooting page: “Troubleshooting MIGRATIONS_FAILED:
missing tables or an incomplete schema on your branch” for Preview
Branch creation.
* Explained why replayed `main` migration history can fail when it no
longer matches the branch’s live schema.
* Included a step-by-step workflow to diagnose the failing migration via
logs, repair migration status, and then recreate or rebase the branch to
verify.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Claude <noreply@anthropic.com>

2026-08-05 18:12:20 +01:00

..

ai

docs: add 384d vectors to addons table

2023-09-14 14:20:37 +03:00

blog

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

cards

Opimize images

2022-12-12 09:54:54 -03:30

database

feat(pipelines): Update product docs and UI copy (#47997)

2026-07-17 11:43:04 +02:00

guides

docs: fix quickstart catalog gaps (#48618)

2026-08-03 13:08:10 +02:00

icons

docs: make AI tools section agent-first (#48167)

2026-07-23 16:01:54 -07:00

integrations

feat: Supabase for Platforms launch (#41056)

2025-12-05 11:42:55 +00:00

ionic-demos

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

launchweek/14

lw14 ticketing #34444

2025-03-27 15:55:47 +00:00

platform

docs: update shared responsibility diagrams (#27813)

2024-07-05 16:53:37 +02:00

showcase-logo

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

storage

docs: Make easier images more readable by AI tools (#47132)

2026-06-24 11:50:26 +02:00

troubleshooting

docs(troubleshooting): troubleshooting guide so users can amend their failed migrations (#48257)

2026-08-05 18:12:20 +01:00

add-contributor.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

auth-5-1.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

auth-5-2.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

auth-5-3.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

auth-5-4.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

auth-5-5.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

auth-5-6.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

auth-5-7.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

auth-5-8.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

auth-deep-dive-2-2.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

auth-deep-dive-2.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

backups-daily-confirmation-modal.png

lw6 final (#11016)

2022-12-16 15:46:16 +01:00

backups-daily-dashboard.png

lw6 final (#11016)

2022-12-16 15:46:16 +01:00

backups-pitr-calendar-view.png

lw6 final (#11016)

2022-12-16 15:46:16 +01:00

backups-pitr-confirmation-modal.png

lw6 final (#11016)

2022-12-16 15:46:16 +01:00

backups-pitr-dashboard.png

lw6 final (#11016)

2022-12-16 15:46:16 +01:00

cdn-cache-hit.png

more storage doc updates

2022-12-13 18:44:56 +08:00

cdn-cache-miss.png

more storage doc updates

2022-12-13 18:44:56 +08:00

check.svg

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

clippy-dark.png

feat(docs-gpt): light-themed clippy

2023-02-01 10:35:33 -07:00

clippy.png

feat(docs-gpt): light-themed clippy

2023-02-01 10:35:33 -07:00

community-august.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

custom-docs.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

deeplink-setting.png

update image

2023-07-25 21:31:01 +09:00

delete-users.gif

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

digital-ocean-emails-errors.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

docker-supabase.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

edge-functions-secrets--light.jpg

Edge functions secrets updates (#31329)

2025-02-25 10:47:59 -03:30

edge-functions-secrets.jpg

Edge functions secrets updates (#31329)

2025-02-25 10:47:59 -03:30

edit-contributors.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

hacktoberfest.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

hn-launch.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

how-client-libs.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

how-replication.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

how-transformation.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

index_advisor_studio.png

Update the index_advisor extension guide (#22750)

2024-04-15 16:35:24 +00:00

invite-users.gif

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

keyboard-shortcuts.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

local-dev-environment--light.svg

replace old diagrams with new ones from design (#21170)

2024-02-12 10:46:35 +00:00

local-dev-environment.svg

replace old diagrams with new ones from design (#21170)

2024-02-12 10:46:35 +00:00

logs-api.png

Opimize images

2022-12-12 09:54:54 -03:30

logs-auth.png

Opimize images

2022-12-12 09:54:54 -03:30

logs-database.png

Opimize images

2022-12-12 09:54:54 -03:30

logs-explorer.png

Opimize images

2022-12-12 09:54:54 -03:30

logs-functions-edge.png

Opimize images

2022-12-12 09:54:54 -03:30

logs-functions.png

Opimize images

2022-12-12 09:54:54 -03:30

logs-realtime.png

Opimize images

2022-12-12 09:54:54 -03:30

logs-storage.png

Opimize images

2022-12-12 09:54:54 -03:30

magic-links.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

monitoro-requests.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

new-sponsor-dark.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

omar-monitoro.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

postgres-views.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

propose-changes.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

purple-glow-dark.png

Opimize images

2022-12-12 09:54:54 -03:30

queues-quickstart-create-dark.png

docs: clarify pgmq rls documentation and integration dashboard (#47082)

2026-06-18 13:30:01 +00:00

queues-quickstart-create-light.png

docs: clarify pgmq rls documentation and integration dashboard (#47082)

2026-06-18 13:30:01 +00:00

queues-quickstart-install-dark.png

docs: clarify pgmq rls documentation and integration dashboard (#47082)

2026-06-18 13:30:01 +00:00

queues-quickstart-install-light.png

docs: clarify pgmq rls documentation and integration dashboard (#47082)

2026-06-18 13:30:01 +00:00

queues-quickstart-queue-settings-dark.png

docs: clarify pgmq rls documentation and integration dashboard (#47082)

2026-06-18 13:30:01 +00:00

queues-quickstart-queue-settings-light.png

docs: clarify pgmq rls documentation and integration dashboard (#47082)

2026-06-18 13:30:01 +00:00

queues-quickstart-queue-settings.png

docs: add screenshot showing queue settings button (#33177)

2025-01-29 23:39:17 +00:00

redwoodjs-qs-connection-strings-pool.png

fix: update connection strings for ipv6/supavisor (#20394)

2024-01-17 11:24:24 -05:00

redwoodjs-qs-countries-ui.png

First draft of RWJS quick start complete with all steps

2023-04-05 07:31:01 -04:00

redwoodjs-qs-new-project.png

First draft of RWJS quick start complete with all steps

2023-04-05 07:31:01 -04:00

refine-qs-countries-ui.png

docs: add refine quick start

2023-07-03 14:52:35 +03:00

release-dec-2020.jpg

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

release-feb-2021.jpg

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

release-jan-2021.jpg

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

restore-after-90-day-dark.png

add guide on restoring project after 90-day pause (#44549)

2026-04-10 07:46:11 +02:00

restore-after-90-day-light.png

add guide on restoring project after 90-day pause (#44549)

2026-04-10 07:46:11 +02:00

roboflow-gallery.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

roboflow-og.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

roboflow-quote.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

roboflow-stat.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

roboflow-website.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

sarup-tayfa.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

sql-editor.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

sso-azure-step-01.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-azure-step-02.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-azure-step-03.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-azure-step-04.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-azure-step-05.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-azure-step-06-1.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-azure-step-06-2.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-azure-step-07.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-dashboard-configure-attributes-azure.png

feat: update the main platform SSO documentation (#37705)

2025-08-06 16:10:23 +00:00

sso-dashboard-configure-attributes-generic.png

feat: update the main platform SSO documentation (#37705)

2025-08-06 16:10:23 +00:00

sso-dashboard-configure-attributes.png

feat: update the main platform SSO documentation (#37705)

2025-08-06 16:10:23 +00:00

sso-dashboard-configure-autojoin-disabled.png

feat: update the main platform SSO documentation (#37705)

2025-08-06 16:10:23 +00:00

sso-dashboard-configure-autojoin-enabled-role.png

feat: update the main platform SSO documentation (#37705)

2025-08-06 16:10:23 +00:00

sso-dashboard-configure-autojoin-enabled.png

feat: update the main platform SSO documentation (#37705)

2025-08-06 16:10:23 +00:00

sso-dashboard-configure-domain-multi.png

feat: update the main platform SSO documentation (#37705)

2025-08-06 16:10:23 +00:00

sso-dashboard-configure-domain.png

feat: update the main platform SSO documentation (#37705)

2025-08-06 16:10:23 +00:00

sso-dashboard-configure-metadata-azure.png

feat: update the main platform SSO documentation (#37705)

2025-08-06 16:10:23 +00:00

sso-dashboard-configure-metadata-gsuite.png

feat: update the main platform SSO documentation (#37705)

2025-08-06 16:10:23 +00:00

sso-dashboard-configure-metadata-okta.png

feat: update the main platform SSO documentation (#37705)

2025-08-06 16:10:23 +00:00

sso-dashboard-disabled.png

feat: update the main platform SSO documentation (#37705)

2025-08-06 16:10:23 +00:00

sso-dashboard-enabled-idp.png

feat(sso): add IdP-initiated login support with optional domains (#44033)

2026-04-20 16:47:35 +00:00

sso-dashboard-enabled.png

feat: update the main platform SSO documentation (#37705)

2025-08-06 16:10:23 +00:00

sso-gsuite-step-01.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-gsuite-step-02.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-gsuite-step-03.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-gsuite-step-04.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-gsuite-step-05.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-gsuite-step-06.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-gsuite-step-08.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-okta-step-01.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-okta-step-02.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-okta-step-03.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-okta-step-04.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-okta-step-05.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

sso-okta-step-06.png

feat: add sso (enterprise login) docs under platform (#10924)

2022-12-13 22:47:06 -08:00

status-page.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

strive-supabase.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-angular-demo.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-architecture--light.svg

docs: update architecture diagram and references from Kong to Envoy (#48557)

2026-07-31 16:00:47 -07:00

supabase-architecture.svg

docs: update architecture diagram and references from Kong to Envoy (#48557)

2026-07-31 16:00:47 -07:00

supabase-december-2020.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-expo-react-native-demo.png

docs: react native expo user management update (#42300)

2026-04-23 12:09:10 +01:00

supabase-expo-social-auth-login.png

docs(react-native): Expo cross-platform social sign-in with complete example (#38178)

2025-09-19 16:53:35 +02:00

supabase-expo-social-auth-tabs.png

docs(react-native): Expo cross-platform social sign-in with complete example (#38178)

2025-09-19 16:53:35 +02:00

supabase-flutter-account-page.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-flutter-demo.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-github-discussions.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-github-stars-june.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-hacktoberfest-board.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-hn-launch.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-january-2021.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-js-1-0.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-logo-wordmark--dark.png

revert lw8 logo and favicon across apps

2023-08-11 23:10:32 +02:00

supabase-logo-wordmark--dark.svg

revert lw8 logo and favicon across apps

2023-08-11 23:10:32 +02:00

supabase-logo-wordmark--light.png

revert lw8 logo and favicon across apps

2023-08-11 23:10:32 +02:00

supabase-logo-wordmark--light.svg

revert lw8 logo and favicon across apps

2023-08-11 23:10:32 +02:00

supabase-middleware-docker.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-monaco-editor.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-monitoro.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-november-2020.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-oauth-logins.png

New example/display image

2023-02-16 13:48:12 -08:00

supabase-october-2020.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-og-image.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-react-demo.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-redwoodjs-demo.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-refine-demo.png

docs: add refine web app tutorial

2023-07-03 11:56:39 +03:00

supabase-september-2020.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-solidjs-demo.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-strive-school.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-svelte-demo.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-swift-demo.png

docs: add getting started guide for Swift (#19044)

2023-11-18 11:50:53 +00:00

supabase-tayfa.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-traffic-may.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-vue-3-demo.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

supabase-xendit.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

tanmai-tayfa.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

toadli-og.jpg

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

typescript-support.gif

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

unnesting-2.png

More files

2022-11-15 18:01:41 -03:30

unnesting-none-dark.png

More files

2022-11-15 18:01:41 -03:30

unnesting-none.png

More files

2022-11-15 18:01:41 -03:30

user-management-demo.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

worklife-dark.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00

yc-gray.png

Rename temp docs to docs

2022-11-03 20:40:03 +07:00