diff --git a/apps/docs/content/troubleshooting/how-to-delete-vercel-linked-projects-9d08aa.mdx b/apps/docs/content/troubleshooting/how-to-delete-vercel-linked-projects-9d08aa.mdx new file mode 100644 index 0000000000..0d4625be92 --- /dev/null +++ b/apps/docs/content/troubleshooting/how-to-delete-vercel-linked-projects-9d08aa.mdx @@ -0,0 +1,171 @@ +--- +title = "How to delete Vercel linked projects" +topics = [ "platform" ] +keywords = [ "vercel", "delete", "marketplace", "projects", "organization" ] +database_id = "9d08aa12-3456-789a-bcde-f012345678ab" + +[api] +--- + +When you create Supabase projects through the Vercel Marketplace, complete deletion requires action on both platforms. + +## Deleting projects + +### Method 1: Delete from Supabase first, then clean up in Vercel + +This method requires two steps - first delete in Supabase, then clean up in Vercel. + +1. **Delete from Supabase Dashboard** + + Go to your [project settings](https://supabase.com/dashboard/project/_/settings/general) and click **"Delete project"**. This permanently removes your database and marks it as "uninstalled" in Vercel. + + Delete project button in Supabase project settings + +2. **Clean up in Vercel** + + After deleting from Supabase, clean up in Vercel: + + - Navigate to your [Vercel dashboard](https://vercel.com/dashboard) + - Go to the **Storage** tab + - Click on the Supabase project (it will show as "uninstalled") + + Uninstalled Supabase project in Vercel Storage + + - Scroll down and find the **Settings** tab in the sidebar + + Vercel project settings navigation + + - Click **Delete Database** to completely remove it + + Delete Database button in Vercel settings{' '} + +### Method 2: Delete directly from Vercel (removes from both platforms) + +This method deletes the project from both Vercel and Supabase in one action. + +1. **Open Vercel dashboard** + + Navigate to your [Vercel dashboard](https://vercel.com/dashboard) and go to the **Storage** tab. + +2. **Select your project** + + Click on your Supabase project to open it. + +3. **Navigate to Settings** + + Find and click the **Settings** tab in the sidebar. + + Vercel project settings navigation + +4. **Delete the project** + + Scroll down and click **Delete Database**. This removes the project from both Vercel and Supabase simultaneously. + + Delete Database button in Vercel settings + +## Transferring projects from Vercel organizations + + + +**Important:** You cannot directly "unlink" a project from a Vercel organization. Instead, you need to transfer the project to another organization. + + + +If you want to move a Vercel-linked project to a different organization: + +1. **Transfer the project** + + Go to your [project settings](https://supabase.com/dashboard/project/_/settings/general) and look for **"Transfer Project"**. Transfer your project to a different organization. + + Transfer project option in Supabase project settings + + Note: The owner must be a member of both the source and target organizations. Transferring a Vercel-managed project will remove its linked Vercel storage from your team. + +2. **Clean up in Vercel** + + After transferring, the project will show as "uninstalled" in Vercel but still appear under Storage. You need to manually delete it: + + - Navigate to your [Vercel dashboard](https://vercel.com/dashboard) + - Go to the **Storage** tab + - Click on the Supabase project (it will show as "uninstalled") + - Go to **Settings** and click **Delete Database** + +3. **Reconnect if needed** + + To reconnect the transferred project after the transfer, use the standard Vercel integration. + +## Deleting the organization + + + +Delete all associated projects before deleting the organization. + + + +1. **Navigate to organization settings and delete** + + Go to your [organization settings](https://supabase.com/dashboard/org/_/general) and click **"Delete organization in Vercel Marketplace"**. This opens the Vercel settings page. + + Delete organization in Vercel Marketplace button + +2. **Uninstall integration** + + Scroll down and click **Uninstall Integration** to fully remove the organization and disconnect it from Vercel. + + Uninstall Integration button in Vercel settings + +## Important notes + +- Projects created through Vercel Marketplace can be deleted from either platform (Supabase or Vercel), with cleanup required on Vercel if deleting from Supabase first. +- Deletion permanently removes all project data. +- After uninstalling the integration, non-Vercel users invited to the organization retain their access. + +## Troubleshooting + +If you encounter issues: + +1. Verify you have necessary permissions in both platforms +2. Refresh your browser and retry +3. Ensure all projects are deleted before deleting the organization +4. [Contact support](https://supabase.com/dashboard/support/new) if problems persist + +## Related resources + +- [Vercel Marketplace integration guide](/docs/guides/integrations/vercel-marketplace) +- [Managing Supabase organizations](/docs/guides/platform/access-control) diff --git a/apps/docs/public/img/troubleshooting/54428354-a1f4-4c44-bd03-d87f4b925d94.png b/apps/docs/public/img/troubleshooting/54428354-a1f4-4c44-bd03-d87f4b925d94.png new file mode 100644 index 0000000000..ea112beea6 Binary files /dev/null and b/apps/docs/public/img/troubleshooting/54428354-a1f4-4c44-bd03-d87f4b925d94.png differ diff --git a/apps/docs/public/img/troubleshooting/627c1a3e-153e-40b5-9a91-a4f7bd7673a4.png b/apps/docs/public/img/troubleshooting/627c1a3e-153e-40b5-9a91-a4f7bd7673a4.png new file mode 100644 index 0000000000..81c666ad57 Binary files /dev/null and b/apps/docs/public/img/troubleshooting/627c1a3e-153e-40b5-9a91-a4f7bd7673a4.png differ diff --git a/apps/docs/public/img/troubleshooting/9c00830a-8901-abcd-ef12-34567890abcd.png b/apps/docs/public/img/troubleshooting/9c00830a-8901-abcd-ef12-34567890abcd.png new file mode 100644 index 0000000000..fc4b16a8a6 Binary files /dev/null and b/apps/docs/public/img/troubleshooting/9c00830a-8901-abcd-ef12-34567890abcd.png differ diff --git a/apps/docs/public/img/troubleshooting/c4e7b193-4567-8901-abcd-ef1234567890.png b/apps/docs/public/img/troubleshooting/c4e7b193-4567-8901-abcd-ef1234567890.png new file mode 100644 index 0000000000..10649da351 Binary files /dev/null and b/apps/docs/public/img/troubleshooting/c4e7b193-4567-8901-abcd-ef1234567890.png differ diff --git a/apps/docs/public/img/troubleshooting/cf450bca-aad3-4783-ae3b-5cc83e0afa54.png b/apps/docs/public/img/troubleshooting/cf450bca-aad3-4783-ae3b-5cc83e0afa54.png new file mode 100644 index 0000000000..19c5a6b1ae Binary files /dev/null and b/apps/docs/public/img/troubleshooting/cf450bca-aad3-4783-ae3b-5cc83e0afa54.png differ diff --git a/apps/docs/public/img/troubleshooting/da70bc33-f123-4567-8901-abcdef123456.png b/apps/docs/public/img/troubleshooting/da70bc33-f123-4567-8901-abcdef123456.png new file mode 100644 index 0000000000..2cea7ebe88 Binary files /dev/null and b/apps/docs/public/img/troubleshooting/da70bc33-f123-4567-8901-abcdef123456.png differ diff --git a/apps/docs/public/img/troubleshooting/e8f50ef1-2b3c-4d5e-9f8a-1234567890ab.png b/apps/docs/public/img/troubleshooting/e8f50ef1-2b3c-4d5e-9f8a-1234567890ab.png new file mode 100644 index 0000000000..50b480e0cc Binary files /dev/null and b/apps/docs/public/img/troubleshooting/e8f50ef1-2b3c-4d5e-9f8a-1234567890ab.png differ diff --git a/apps/docs/public/img/troubleshooting/f294a4d6-ef12-3456-7890-abcdef123456.png b/apps/docs/public/img/troubleshooting/f294a4d6-ef12-3456-7890-abcdef123456.png new file mode 100644 index 0000000000..7761da27ba Binary files /dev/null and b/apps/docs/public/img/troubleshooting/f294a4d6-ef12-3456-7890-abcdef123456.png differ diff --git a/apps/docs/public/img/troubleshooting/ff01bba8-abcd-ef12-3456-7890abcdef12.png b/apps/docs/public/img/troubleshooting/ff01bba8-abcd-ef12-3456-7890abcdef12.png new file mode 100644 index 0000000000..c781daef2b Binary files /dev/null and b/apps/docs/public/img/troubleshooting/ff01bba8-abcd-ef12-3456-7890abcdef12.png differ