diff --git a/apps/reference/_supabase_js/upgrade-guide.mdx b/apps/reference/_supabase_js/upgrade-guide.mdx
index 71f46c8151b..71f00e4b9b1 100644
--- a/apps/reference/_supabase_js/upgrade-guide.mdx
+++ b/apps/reference/_supabase_js/upgrade-guide.mdx
@@ -299,6 +299,15 @@ const supabase = createClient(SUPABASE_URL, SUPABASE_ANON_KEY, {
 </TabItem>
 </Tabs>
 
+#### Cookie methods
+
+The cookie related methods like `setAuthCookie` and `getUserByCookie` have been removed.
+
+For Next.js you can use the [Auth Helpers](https://supabase.com/docs/guides/auth/auth-helpers/nextjs) to help you manage cookies.
+If you can't use the Auth Helpers, you can follow [this approach](https://supabase.com/docs/guides/auth/server-side-rendering) for server-side rendering.
+
+Some more background information about the reasoning can be obtained [here](https://github.com/supabase/gotrue-js/pull/340).
+
 ### Data methods
 
 `.insert()` / `.upsert()` / `.update()` / `.delete()` don't return rows by default: [PR](https://github.com/supabase/postgrest-js/pull/276).