Multi Session

The Multi Session plugin lets users stay signed in to multiple accounts at once, switch the active account from the user menu, and manage device sessions from account settings.

It contributes:

• A plugin-injected switch-account submenu inside <UserButton />
• A plugin-injected <ManageAccounts /> card inside <AccountSettings />
• Solid runtime helpers for listing, switching, and revoking device sessions

Setup

import { betterAuth } from "better-auth"
import { multiSession } from "better-auth/plugins"

export const auth = betterAuth({
  // ...
  plugins: [
    multiSession() 
  ]
})

import { createAuthClient } from "@better-auth-ui/solid"
import { multiSessionClient } from "better-auth/client/plugins"

export const authClient = createAuthClient({
  plugins: [multiSessionClient()] 
})

npx shadcn@latest add https://better-auth-ui.com/r/solid/multi-session.json

import { AuthProvider } from "@/components/auth/auth-provider"
import { multiSessionPlugin } from "@/lib/auth/multi-session-plugin"

<AuthProvider
  authClient={authClient}
  plugins={[multiSessionPlugin()]} 
>
  {children}
</AuthProvider>

Components

<UserButton />

When multiSessionPlugin() is registered, <UserButton /> renders plugin-contributed user menu items, including the switch-account submenu.

import { UserButton } from "@/components/auth/user/user-button"

<UserButton />

<SwitchAccountSubmenu />

import { SwitchAccountSubmenu } from "@/components/auth/multi-session/switch-account-submenu"

<SwitchAccountSubmenu />

<ManageAccounts />

<ManageAccounts /> is rendered through plugin-contributed accountCards, so it appears inside <AccountSettings /> when the plugin is registered.

import { ManageAccounts } from "@/components/auth/multi-session/manage-accounts"

<ManageAccounts />

Options

The copied local wrapper accepts the same core plugin options:

multiSessionPlugin({
  localization: {
    switchAccount: "Switch Account",
    addAccount: "Add account",
    manageAccounts: "Manage accounts"
  }
})

Localization

The copied submenu and manage-accounts components read localization from the registered plugin first, then fall back to the core defaults.

Session management

The copied Solid components use the Solid runtime helpers directly:

• listDeviceSessionsOptions
• setActiveSessionOptions
• revokeMultiSessionOptions

References:

• listDeviceSessionsOptions
• setActiveSessionOptions
• revokeMultiSessionOptions

These APIs power the switch-account submenu, current-session indicator, add-account navigation, and device-session revoke/switch actions.