3 people 2df9d1ebca Docs/update troubleshooting guide rotate jwt (#41689) ...

* updated the rotating anon, service role and jwt secret troubleshooting guide to reflect new ui changes

* added auth faq documentation link

* implemented review suggestions

* updated heading markdown for further readings section

* implemented: heading should be sentence cased

* implemented lint rules

* disabled linter rule for the section. UI has the same wording mentioned in the guide

* nitpicks

Co-authored-by: Chris Chinchilla <chris.ward@supabase.io>

* Update apps/docs/content/troubleshooting/rotating-anon-service-and-jwt-secrets-1Jq6yd.mdx

Co-authored-by: Chris Chinchilla <chris.ward@supabase.io>

* Update apps/docs/content/troubleshooting/rotating-anon-service-and-jwt-secrets-1Jq6yd.mdx

Co-authored-by: Chris Chinchilla <chris.ward@supabase.io>

* Update apps/docs/content/troubleshooting/rotating-anon-service-and-jwt-secrets-1Jq6yd.mdx

* Update apps/docs/content/troubleshooting/rotating-anon-service-and-jwt-secrets-1Jq6yd.mdx

* Update apps/docs/content/troubleshooting/rotating-anon-service-and-jwt-secrets-1Jq6yd.mdx

* Update apps/docs/content/troubleshooting/rotating-anon-service-and-jwt-secrets-1Jq6yd.mdx

---------

Co-authored-by: Vaibhav <117663341+7ttp@users.noreply.github.com>
Co-authored-by: Chris Chinchilla <chris.ward@supabase.io>

2026-01-08 10:06:35 +01:00

..

_template.mdx

feat(docs): main troubleshooting page (#29120)

2024-10-02 17:10:12 +00:00

42501--permission-denied-for-table-httprequestqueue-KnozmQ.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

all-about-supabase-egress-a_Sg_e.mdx

feat(docs): refs updated from reports to observability (#40470)

2025-11-18 18:20:34 +00:00

an-invalid-response-was-received-from-the-upstream-server-error-when-querying-auth-RI4Vl-.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

are-all-features-available-in-self-hosted-supabase-THPcqw.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

auth-error-401-invalid-claim-missing-sub--AFwMR.mdx

docs: update troubleshooting for invalid claim (#33884)

2025-02-27 15:43:07 -05:00

avoiding-timeouts-in-long-running-queries-6nmbdN.mdx

Update connect dialog link params (#40002)

2025-10-30 14:41:49 +01:00

canceling-statement-due-to-statement-timeout-581wFv.mdx

fix query performance links (#38738)

2025-09-16 13:58:55 +02:00

cant-access-supabase-project-lovable-cloud.mdx

feat(docs): add lovable cloud troubleshooting guides (#40115)

2025-11-04 18:41:31 +01:00

certain-operations-are-too-complex-to-perform-directly-using-the-client-libraries-8JaphH.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

change-email-associated-with-supabase-account-T5eHNT.mdx

docs: Update change email guide to include Vercel and add extra notes (#40771)

2025-11-27 10:57:41 +01:00

change-project-region-eWJo5Z.mdx

fix(docs): incorrrect link to migrations doc (#34141)

2025-03-12 11:51:58 +01:00

check-usage-for-monthly-active-users-mau-MwZaBs.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

converted-github-account-to-organisation---lost-supabase-account-access-5wsE_1.mdx

Update Supabase lost account access due to Github account troubleshooting doc (#39274)

2025-11-03 17:02:31 +01:00

customizing-emails-by-language-KZ_38Q.mdx

docs: Fixed documentation issues on "Customizing Emails by Language" page (#38782)

2025-12-16 15:39:09 +00:00

dashboard-errors-when-managing-users-N1ls4A.mdx

Fix broken links and remove custom anchor (#40298)

2025-11-10 19:35:15 +08:00

database-api-42501-errors.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

database-error-remaining-connection-slots-are-reserved-for-non-replication-superuser-connections-3V3nIb.mdx

[bot] sync troubleshooting guides to db (#32893)

2025-01-18 01:36:49 +00:00

database-error-saving-new-user-RU_EwB.mdx

[bot] sync troubleshooting guides to db (#32874)

2025-01-17 21:43:43 +00:00

deprecated-rls-features-Pm77Zs.mdx

migrate(docs): troubleshooting 14 (#30944)

2025-01-17 23:48:14 +00:00

disabling-prepared-statements-qL8lEL.mdx

fix: typos + add more spelling exceptions (#33328)

2025-02-04 15:40:54 -05:00

discovering-and-interpreting-api-errors-in-the-logs-7xREI9.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

do-i-need-to-expose-security-definer-functions-in-row-level-security-policies-iI0uOw.mdx

fix: typos + add more spelling exceptions (#33328)

2025-02-04 15:40:54 -05:00

download-logical-backups.mdx

docs: Update backups troubleshooting guide (#40758)

2025-11-27 10:54:48 +01:00

edge-function-fails-deploy.mdx

docs: Add troubleshooting doc for Edge functiosn failing deploys (#40077)

2025-11-03 16:58:27 +01:00

edge-function-shutdown-reasons-explained.mdx

fix(troubleshooting sync) (#40096)

2025-11-04 08:16:46 +01:00

edge-function-wall-clock-time-limit-reached-Nk38bW.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

email-template-not-updating.mdx

docs: Add troubleshooting for email templates not updating (#40035)

2025-11-04 09:53:53 +01:00

enabling-ipv4-addon.mdx

docs: add ipv4 troubleshooting (#38987)

2025-09-25 10:01:42 -07:00

error-connection-refused-when-trying-to-connect-to-supabase-database-hwG0Dr.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

error-index-row-size-exceeds-btree-version-4-maximum-for-index-LMmoeU.mdx

chore: fix formatting (#41054)

2025-12-04 11:23:41 +00:00

error-invalid-totp-code-entered-CukLCj.mdx

chore: docs linting (#33574)

2025-02-21 14:13:00 -05:00

error-no-pghbaconf-entry-for-host-xxxxxxxxxxx-user-postgres-database-postgres-ssl-off-GOt5Ja.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

error-prepared-statement-xxx-already-exists-3laqeM.mdx

[bot] sync troubleshooting guides to db (#32847)

2025-01-17 00:28:57 +00:00

exhaust-disk-io.mdx

feat(docs): refs updated from reports to observability (#40470)

2025-11-18 18:20:34 +00:00

exhaust-ram.mdx

feat(docs): refs updated from reports to observability (#40470)

2025-11-18 18:20:34 +00:00

exhaust-swap.mdx

feat(docs): refs updated from reports to observability (#40470)

2025-11-18 18:20:34 +00:00

failed-to-fetch-in-dashboard-and-other-areas----browser-extension-dyDTRU.mdx

[bot] sync troubleshooting guides to db (#32891)

2025-01-18 01:04:38 +00:00

failed-to-restore-from-backup-all-subscriptions-and-replication-slots-must-be-dropped-before-a-backup-can-be-restored-L-rCvt.mdx

[bot] sync troubleshooting guides to db (#32895)

2025-01-18 01:54:43 +00:00

failed-to-run-sql-query-connection-terminated-due-to-connection-timeout.mdx

Update troubleshooting guide to mention restarting (#41781)

2026-01-08 14:05:50 +05:30

fetch-requests-to-api-endpoints-arent-showing-the-session-UbUwRs.mdx

[bot] sync troubleshooting guides to db (#32889)

2025-01-18 00:42:54 +00:00

fixing-520-errors-in-the-database-rest-api-Ur5-B2.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

forbidden-resource-error-from-the-cli-L6rm6l.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

google-auth-fails-for-some-users-XcFXEu.mdx

[bot] sync troubleshooting guides to db (#32879)

2025-01-17 22:07:11 +00:00

grafana-not-displaying-data-sXJrMj.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

high-cpu-and-slow-queries-with-error-must-be-a-superuser-to-terminate-superuser-process.mdx

[bot] Sync from supabase/troubleshooting (#40147)

2025-11-04 18:25:12 +00:00

high-cpu-usage.mdx

feat(docs): refs updated from reports to observability (#40470)

2025-11-18 18:20:34 +00:00

high-latency-with-supabase-client-z0pZzR.mdx

fix: typos + add more spelling exceptions (#33328)

2025-02-04 15:40:54 -05:00

how-can-i-revoke-execution-of-a-postgresql-function-2GYb0A.mdx

[bot] sync troubleshooting guides to db (#32873)

2025-01-17 20:20:14 +00:00

how-do-i-check-gotrueapi-version-of-a-supabase-project-lQAnOR.mdx

[bot] sync troubleshooting guides to db (#32879)

2025-01-17 22:07:11 +00:00

how-do-i-make-the-cookies-httponly-vwweFx.mdx

[bot] sync troubleshooting guides to db (#32879)

2025-01-17 22:07:11 +00:00

how-do-i-reset-my-supabase-database-password-oTs5sB.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

how-do-i-update-connection-pool-settings-in-my-dashboard-wAxTJ_.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

how-do-you-troubleshoot-nextjs---supabase-auth-issues-riMCZV.mdx

docs: update supabase docs for nextjs 16 proxyts change (#40555)

2025-12-01 16:53:12 +01:00

how-long-does-it-take-to-restore-a-database-from-a-point-in-time-backup-pitr-qO8gOG.mdx

[bot] sync troubleshooting guides to db (#32895)

2025-01-18 01:54:43 +00:00

how-postgres-chooses-which-index-to-use-_JHrf4.mdx

chore: docs linting (#33574)

2025-02-21 14:13:00 -05:00

how-to-bypass-cooldown-period.mdx

Docs: add guide on bypassing disk resize cooldown period (#35405)

2025-10-31 18:53:55 +01:00

how-to-change-max-database-connections-_BQ8P5.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

how-to-check-if-my-queries-are-being-blocked-by-other-queries-NSKtR1.mdx

[bot] sync troubleshooting guides to db (#32881)

2025-01-17 22:58:25 +00:00

how-to-delete-a-role-in-postgres-8-AvxY.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

how-to-delete-vercel-linked-projects-9d08aa.mdx

fix(docs): use regular image markdown to fix doc sync (#39513)

2025-10-14 15:05:44 +08:00

how-to-interpret-and-explore-the-postgres-logs-OuCIOj.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

how-to-migrate-from-supabase-auth-helpers-to-ssr-package-5NRunM.mdx

docs: update supabase docs for nextjs 16 proxyts change (#40555)

2025-12-01 16:53:12 +01:00

how-to-view-database-metrics-uqf2z_.mdx

feat(docs): refs updated from reports to observability (#40470)

2025-11-18 18:20:34 +00:00

http-api-issues.mdx

feat(docs): refs updated from reports to observability (#40470)

2025-11-18 18:20:34 +00:00

http-status-codes.mdx

docs: split telemetry and troubleshooting sections (#33223)

2025-02-03 18:00:33 -05:00

i-am-not-receiving-password-reset-emails-for-supabase-dashboard--cO5yf.mdx

chore: docs linting (#33574)

2025-02-21 14:13:00 -05:00

identify-lovable-cloud-or-supabase-backend.mdx

feat(docs): add lovable cloud troubleshooting guides (#40115)

2025-11-04 18:41:31 +01:00

importing-stripe-or-other-modules-from-esmsh-on-deno-edge-functions-throws-an-error-TmbB5p.mdx

[bot] sync troubleshooting guides to db (#32845)

2025-01-16 19:17:17 -05:00

increase-vector-lookup-speeds-by-applying-an-hsnw-index-ohLHUM.mdx

Update connect dialog link params (#40002)

2025-10-30 14:41:49 +01:00

inserting-into-sequenceserial-table-causes-duplicate-key-violates-unique-constraint-error-pi6DnC.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

inspecting-edge-function-environment-variables-wg5qOQ.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

insufficient-privilege-when-accessing-pgstatstatements-e5M_EQ.mdx

fix query performance links (#38738)

2025-09-16 13:58:55 +02:00

interpreting-supabase-grafana-cpu-charts-9JSlkC.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

interpreting-supabase-grafana-io-charts-MUynDR.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

jwt-expired-error-in-supabase-dashboard-F06k3x.mdx

[bot] sync troubleshooting guides to db (#32891)

2025-01-18 01:04:38 +00:00

lost-accessforgot-the-mfa-device-nAPT-7.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

memory-and-swap-usage-explained-aPNgm0.mdx

fix: typos + add more spelling exceptions (#33328)

2025-02-04 15:40:54 -05:00

migrating-auth-users-between-projects.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

monitor-supavisor-postgres-connections.mdx

feat(docs): refs updated from reports to observability (#40470)

2025-11-18 18:20:34 +00:00

new-branch-doesnt-copy-database.mdx

troubleshooting guide for users seeing empty branches due to no migrations (#39293)

2025-10-20 14:37:21 +01:00

new-variable-is-null-in-a-trigger-function--l9AOZ.mdx

[bot] sync troubleshooting guides to db (#32785)

2025-01-16 18:11:52 -05:00

nextjs-1314-stale-data-when-changing-rls-or-table-data-85b8oQ.mdx

chore: docs linting (#33574)

2025-02-21 14:13:00 -05:00

no-toast-messages-on-the-dashboard-BrvP8h.mdx

[bot] sync troubleshooting guides to db (#32891)

2025-01-18 01:04:38 +00:00

not-receiving-auth-emails-from-the-supabase-project-OFSNzw.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

oauth-sign-in-isnt-redirecting-on-the-server-side-ShGMtr.mdx

fix: typos + add more spelling exceptions (#33328)

2025-02-04 15:40:54 -05:00

partitioning-an-existing-table-with-same-name-VEnbzK.mdx

fix: typos + add more spelling exceptions (#33328)

2025-02-04 15:40:54 -05:00

pausing-pro-projects-vNL-2a.mdx

fix(docs): Update migrate links (#39419)

2025-10-10 16:48:22 +08:00

performing-administration-tasks-on-the-server-side-with-the-servicerole-secret-BYM4Fa.mdx

docs(troubleshooting): make docs on server-side admin clearer (#35815)

2025-05-26 21:49:47 -02:30

pgcron-debugging-guide-n1KTaz.mdx

feat(docs): refs updated from reports to observability (#40470)

2025-11-18 18:20:34 +00:00

pgrst106-the-schema-must-be-one-of-the-following-error-when-querying-an-exposed-schema.mdx

[bot] Sync from supabase/troubleshooting (#40147)

2025-11-04 18:25:12 +00:00

prisma-error-management-Cm5P_o.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

project-status-reports-unhealthy-services.mdx

docs: Add troubleshooting for unhealthy services (#40462)

2025-11-16 11:02:00 +01:00

realtime-concurrent-peak-connections-quota-jdDqcp.mdx

migrate(docs): troubleshooting 14 (#30944)

2025-01-17 23:48:14 +00:00

realtime-connections-timed_out-status.mdx

[bot] Sync from supabase/troubleshooting (#40147)

2025-11-04 18:25:12 +00:00

realtime-debugging-with-logger.mdx

docs: Remove empty troubleshooting fields (#41236)

2025-12-10 15:50:13 +00:00

realtime-heartbeat-messages.mdx

docs: Remove empty troubleshooting fields (#41236)

2025-12-10 15:50:13 +00:00

realtime-too-many-channels-error.mdx

docs: Remove empty troubleshooting fields (#41236)

2025-12-10 15:50:13 +00:00

refresh-postgrest-schema.mdx

[bot] sync troubleshooting guides to db (#39575)

2025-10-16 17:15:34 +00:00

resolving-42p01-relation-does-not-exist-error-W4_9-V.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

resolving-500-status-authentication-errors-7bU5U8.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

resolving-database-hostname-and-managing-your-ip-address-pVlwE0.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

rls-performance-and-best-practices-Z5Jjwv.mdx

fix: 34423 (#34714)

2025-04-04 14:47:31 +00:00

rls-simplified-BJTcS8.mdx

chore: docs linting (#33574)

2025-02-21 14:13:00 -05:00

rotating-anon-service-and-jwt-secrets-1Jq6yd.mdx

Docs/update troubleshooting guide rotate jwt (#41689)

2026-01-08 10:06:35 +01:00

security-of-anonymous-sign-ins-iOrGCL.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

seeing-no-pghbaconf-entry-for-host-errors-in-postgres-and-they-come-from-an-ip-address-that-i-dont-recognize-4gds9f.mdx

fix: typos + add more spelling exceptions (#33328)

2025-02-04 15:40:54 -05:00

should-i-set-a-shorter-max-age-parameter-on-the-cookies-8sbF4V.mdx

docs: Update out of date mentions of getUser (#40045)

2025-11-03 12:46:32 +01:00

slow-execution-of-alter-table-on-large-table-when-changing-column-type-qmZRpZ.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

soft-deletes-with-supabase-js.mdx

[bot] sync troubleshooting guides to db (#36202)

2025-06-05 17:31:59 +00:00

sso-error-you-do-not-have-permissions-to-join-this-organization-or-prompts-to-create-new-organization.mdx

[bot] Sync from supabase/troubleshooting (#40147)

2025-11-04 18:25:12 +00:00

steps-to-improve-query-performance-with-indexes-q8PoC9.mdx

feat(docs): refs updated from reports to observability (#40470)

2025-11-18 18:20:34 +00:00

supabase--your-network-ipv4-and-ipv6-compatibility-cHe3BP.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

supabase-cli-failed-sasl-auth-or-invalid-scram-server-final-message.mdx

[bot] Sync from supabase/troubleshooting (#40147)

2025-11-04 18:25:12 +00:00

supabase-dashboard-not-loading-project-not-loading-on-dashboard-LfMq9F.mdx

chore: docs linting (#33574)

2025-02-21 14:13:00 -05:00

supabase-grafana-memory-charts.mdx

docs: Fix broken URLS batch 3 (#40508)

2025-11-28 10:56:17 +00:00

supavisor-and-connection-terminology-explained-9pr_ZO.mdx

fix: typos + add more spelling exceptions (#33328)

2025-02-04 15:40:54 -05:00

supavisor-faq-YyP5tI.mdx

Update connect dialog link params (#40002)

2025-10-30 14:41:49 +01:00

transferring-from-cloud-to-self-host-in-supabase-2oWNvW.mdx

[bot] sync troubleshooting guides to db (#32779)

2025-01-14 23:49:18 +00:00

understanding-postgresql-explain-output-Un9dqX.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

understanding-postgresql-logging-levels-and-how-they-impact-your-project-KXiJRm.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

understanding-the-usage-summary-on-the-dashboard-D7Gnle.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

upload-file-size-restrictions-Y4wQLT.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

using-google-smtp-with-supabase-custom-smtp-ZZzU4Y.mdx

chore: docs linting (#33574)

2025-02-21 14:13:00 -05:00

using-sqlalchemy-with-supabase-FUqebT.mdx

Update connect dialog link params (#40002)

2025-10-30 14:41:49 +01:00

webhook-debugging-guide-M8sk47.mdx

chore: replace all supabase urls with relative urls (#38537)

2025-09-09 12:54:33 +00:00

why-am-i-being-redirected-to-the-wrong-url-when-using-auth-redirectto-option-_vqIeO.mdx

docs: clarify site url and redirect urls configuration (#39455)

2025-10-29 17:07:02 +00:00

why-are-there-gaps-in-my-postgres-id-sequence-Frifus.mdx

chore: docs linting (#33574)

2025-02-21 14:13:00 -05:00

why-cant-i-uploadlistetc-my-public-bucket-Z6CmGt.mdx

[bot] sync troubleshooting guides to db (#32781)

2025-01-15 00:04:06 +00:00

why-do-i-see-auth--api-requests-in-the-dashboard-my-app-has-no-users-CyadiO.mdx

fix: typos + add more spelling exceptions (#33328)

2025-02-04 15:40:54 -05:00

why-is-my-camelcase-name-not-working-in-postgres-functions-or-rls-policies-EJMzVd.mdx

migrate(docs): troubleshooting 19 (#30945)

2025-01-17 23:17:25 +00:00

why-is-my-select-returning-an-empty-data-array-and-i-have-data-in-the-table-xvOPgx.mdx

chore: docs linting (#33574)

2025-02-21 14:13:00 -05:00

why-is-my-service-role-key-client-getting-rls-errors-or-not-returning-data-7_1K9z.mdx

fix: typos + add more spelling exceptions (#33328)

2025-02-04 15:40:54 -05:00

why-is-my-supabase-api-call-not-returning-PGzXw0.mdx

fix: typos + add more spelling exceptions (#33328)

2025-02-04 15:40:54 -05:00

will-backups-be-accessible-from-the-dashboard-immediately-after-upgrading-to-a-paid-plan-hXY4rs.mdx

chore: docs linting (#33574)

2025-02-21 14:13:00 -05:00