useSessionList()

Returns
Example
1. Get a list of sessions

Available in other SDKs

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

Returns

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 .

Name	Type
`isLoaded`	`true`
`sessions`	`[]`
`setActive`	`SetActive`

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 HomePage() {
  const { isLoaded, sessions } = useSessionList()

  if (!isLoaded) {
    // Handle loading state
    return null
  }

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

Edit on GitHub

Last updated on Oct 1, 2025

useSessionList()

Returns

Example

Get a list of sessions

Feedback