diff --git a/apps/docs/content/troubleshooting/cant-access-supabase-project-lovable-cloud.mdx b/apps/docs/content/troubleshooting/cant-access-supabase-project-lovable-cloud.mdx
new file mode 100644
index 00000000000..3e2140e23b8
--- /dev/null
+++ b/apps/docs/content/troubleshooting/cant-access-supabase-project-lovable-cloud.mdx
@@ -0,0 +1,131 @@
+---
+title = "Can’t Access Supabase Project When Using Lovable Cloud"
+topics = [
+"ai",
+]
+keywords = [
+"lovable",
+"lovable cloud"
+]
+---
+
+## Problem
+
+Your Lovable project has **Lovable Cloud** enabled, and you’re trying to connect directly to your Supabase project.
+
+However, you don’t see the project listed on your [Supabase Dashboard](/dashboard), or you’re unable to access it through your Supabase account.
+
+## Why this occurs
+
+When you create a project connected to **Lovable Cloud**, the underlying Supabase instance is provisioned and managed entirely by **Lovable**.
+
+These projects are not owned by your Supabase account, so they **don't appear on your Supabase Dashboard** or be accessible using your Supabase credentials.
+
+## How to diagnose
+
+You might be affected by this if:
+
+- You recently created a project on Lovable and enabled the backend from the chat interface. By default, the Lovable platform uses **Lovable Cloud** for backend hosting.
+- You see Supabase references in your project’s configuration but **can’t access the project** from your [Supabase Dashboard](/dashboard).
+- The project ID or credentials used in your Lovable setup don’t match any project under your Supabase account.
+
+## How to fix
+
+There is **no automated way** to transfer a Supabase project from Lovable Cloud to your own Supabase account.
+
+However, you can manually clone your project backend and migrate your data following Lovable’s official guide: [Self-Hosting Guide (Lovable Docs)](https://docs.lovable.dev/tips-tricks/self-hosting)
+
+This process allows you to create a new Supabase project under your own account and connect it independently.
+
+
+
+There are certain limitations described in Lovable’s documentation, so review the guide carefully before proceeding.
+
+
+
+## How to prevent
+
+If you want direct access to your Supabase project from the start, make sure to:
+
+- Avoid enabling Lovable Cloud if you plan to manage your Supabase project independently.
+- Create your project directly from the [Supabase Dashboard](/dashboard) and then **manually connect your Lovable project to your Supabase project**, or **start your Lovable project already connected** to your own Supabase project from the beginning.
+
+## Additional resources
+
+For more information, read [the Lovable Cloud FAQ](https://docs.lovable.dev/features/cloud#faq)
+
+## Frequently asked questions
+
+
+
+
+
+ No. Projects running on **Lovable Cloud** use a managed Supabase backend that doesn't provide direct SQL editor access through [supabase.com/dashboard](/dashboard).
+
+
+
+
+
+
+ Lovable Cloud projects are owned and managed by **Lovable**, not by your personal Supabase account. They won't show up on your dashboard.
+
+
+
+
+
+
+ Once Lovable Cloud is enabled for a project, it **cannot be disconnected or switched** to an external Supabase connection.
+
+ However, you can **create a new Supabase project under your own account** and migrate your data by following Lovable's [Project Migration Guide](https://docs.lovable.dev/tips-tricks/self-hosting).
+
+
+
+
+
+
+ External connections are **not supported** when your project runs on Lovable Cloud.
+
+
+
+
+
+
+ Service role and API keys are **not accessible** for Lovable Cloud–managed projects.
+
+ If you need to integrate with external automation or API-based tools, you'll need to **create and manage your own Supabase project**, then connect Lovable to it directly.
+
+
+
+
+
+
+ No. Lovable Cloud only affects your **backend connection** (database and APIs), not your app hosting or frontend.
+
+
+
+
+
+
+ No. Lovable Cloud backend is managed entirely by Lovable, and connection credentials are not exposed.
+
+
+
+
+
+
+ There's no automated way to transfer your backend. You can create a new Supabase project and connect your Lovable app to it manually.
+
+ See [Lovable's Project Migration Guide](https://docs.lovable.dev/tips-tricks/self-hosting) for detailed steps.
+
+
+
+
+
+
+ There's no automated way to transfer your backend from Lovable Cloud to your own Supabase account.
+
+ You can create a new Supabase project and migrate your data manually.
+
+ See [Can't Access Your Supabase Project When Using Lovable Cloud](/docs/guides/troubleshooting/cant-access-supabase-project-lovable-cloud) for more details.
+
+
+
+
+
+
+ That's expected — Lovable Cloud backend is managed by Lovable and doesn't appear in your Supabase Dashboard.
+
+ Learn more in [Can't Access Your Supabase Project When Using Lovable Cloud](/docs/guides/troubleshooting/cant-access-supabase-project-lovable-cloud).
+
+
+
+