This documentation is for a legacy version of Next.js and Supabase. For the latest version, please visit the Next.js and Supabase V2 documentation

Fetching the signed in User

Learn how to fetch the signed in user from the backend and frontend.

There are several ways to fetch the signed in user, depending on the use-case.

Fetching the signed in user from the backend

To do so, use the function requireSession, which also takes care of redirecting the user to the login page if they are not signed in, and checking the correct MFA access level if the user opted in.

You can use this function in:

  • API Routes
  • Server Actions
  • Server Components

Using "requireSession" in API Routes

When using API routes, you can retrieve the signed in user using the requireSession function.

import getSupabaseRouteHandlerClient from '~/core/supabase/route-handler-client';
import requireSession from '~/lib/user/require-session';
export async function POST() {
const client = getSupabaseRouteHandlerClient();
const session = await requireSession(client);
}

Using "requireSession" in Server Actions

When using server actions, you can retrieve the signed in user using the requireSession function.

'use server';
import getSupabaseRouteHandlerClient from '~/core/supabase/route-handler-client';
import requireSession from '~/lib/user/require-session';
export async function yourServerAction() {
const client = getSupabaseRouteHandlerClient();
const session = await requireSession(client);
// use session here
}

Using "requireSession" in Server Components

You can use the requireSession function in Server Components as well.

async function PageComponent() {
const client = getSupabaseServerComponentClient();
const session = await requireSession(client);
// use session here
}

Fetching the signed in user from the frontend

When in the scope of the app/dashboard/[organization] layout, the app automatically injects the user session in the context layout.

This includes the user ID, email, and other authentication data, as well as the user's Supabase DB record.

Getting the user Session with "useUserSession"

To retrieve the signed in user from the frontend, you can use the useUserSession hook:

import useUserSession from '~/core/hooks/use-user-session';
const userSession = useUserSession();

This is a React hook and can only be used inside a React component.

Getting the user ID with "useUserId"

To retrieve the signed in user ID from the frontend, you can use the useUserId hook:

import useUserId from '~/core/hooks/use-user-id';
const userId = useUserId();

This is a React hook and can only be used inside a React component.

Getting the user role within the organization with "useUserRole"

To retrieve the signed in user role of the current organization from the frontend, you can use the useUserRole hook:

import useCurrentUserRole from '~/core/hooks/use-current-user-role';
const role = useCurrentUserRole();

This is a React hook and can only be used inside a React component.