useSessionList()

Returns
Example
1. Get a list of sessions

Available in other SDKs

The useSessionList() hook returns an array of Session objects that have been registered on the client device.

Returns

There are multiple variants of this type available which you can select by clicking on one of the tabs.

Initialization

Loaded

Name
isLoaded
Type
false
Description
A boolean that indicates whether Clerk has completed initialization. Initially false, becomes true once Clerk loads.
Name
sessions
Type
undefined
Description
A list of sessions that have been registered on the client device.
Name
setActive
Type
undefined
Description
A function that sets the active session and/or Organization. See the reference doc.

Name
isLoaded
Type
true
Description
A boolean that indicates whether Clerk has completed initialization. Initially false, becomes true once Clerk loads.
Name
sessions
Type
SessionResource[]
Description
A list of sessions that have been registered on the client device.
Name
setActive()
Type
(setActiveParams: SetActiveParams) => Promise<void>
Description
A function that sets the active session and/or Organization. See the reference doc.

The following example uses useSessionList() to get a list of sessions that have been registered on the client device. The sessions property is used to show the number of times the user has visited the page.

app/home/page.tsx

'use client'

import { useSessionList } from '@clerk/nextjs'

export default function Page() {
  const { isLoaded, sessions } = useSessionList()

  // Handle loading state
  if (!isLoaded) return <div>Loading...</div>

  return (
    <div>
      <p>Welcome back. You've been here {sessions.length} times before.</p>
    </div>
  )
}

Last updated on Feb 10, 2026

Edit on GitHub

useSessionList()

Returns

Example

Get a list of sessions

Feedback