Clerk logo

Clerk Docs

Ctrl + K
Go to clerk.devGet API keys

<UserButton />

A component that allows users to manage their account, switch accounts, or sign out

Overview

The <UserButton/> component is used to render the familiar user button UI popularized by Google. Learn more about the <UserButton/> component, what it is, and how it is used by reading our User Button component guide.

Usage

1
import {
2
ClerkProvider,
3
SignedIn,
4
SignedOut,
5
SignInButton,
6
UserButton
7
} from "@clerk/nextjs";
8
9
function Header() {
10
return (
11
<header
12
style={{ display: "flex", justifyContent: "space-between", padding: 20 }}
13
>
14
<h1>My App</h1>
15
<SignedIn>
16
{/* Mount the UserButton component */}
17
<UserButton />
18
</SignedIn>
19
<SignedOut>
20
{/* Signed out users get sign in button */}
21
<SignInButton />
22
</SignedOut>
23
</header>
24
);
25
}
26
27
function MyApp({ pageProps }) {
28
return (
29
<ClerkProvider {...pageProps}>
30
<Header />
31
</ClerkProvider>
32
);
33
}
34
35
export default MyApp;
1
import {
2
ClerkProvider,
3
SignedIn,
4
SignedOut,
5
SignInButton,
6
UserButton
7
} from "@clerk/clerk-react";
8
9
const frontendApi = process.env.REACT_APP_CLERK_FRONTEND_API;
10
11
function Header() {
12
return (
13
<header
14
style={{ display: "flex", justifyContent: "space-between", padding: 20 }}
15
>
16
<h1>My App</h1>
17
<SignedIn>
18
{/* Mount the UserButton component */}
19
<UserButton />
20
</SignedIn>
21
<SignedOut>
22
{/* Signed out users get sign in button */}
23
<SignInButton />
24
</SignedOut>
25
</header>
26
);
27
}
28
29
function App() {
30
return (
31
<ClerkProvider frontendApi={frontendApi}>
32
<Header />
33
</ClerkProvider>
34
);
35
}
36
37
export default App;
1
<html>
2
<body>
3
<div id="user-button"></div>
4
5
<script>
6
const el = document.getElementById("user-button");
7
// Mount the pre-built Clerk UserButton component
8
// inside an HTMLElement on your page.
9
window.Clerk.mountUserButton(el);
10
</script>
11
</body>
12
</html>

Props

NameTypeDescription
appearance?Theme

Controls the overall look and feel

showName?string

Controls if the user name is displayed next to the user image button.

signInUrl?string

The full URL or path to navigate to when the "Add another account" button is clicked.

userProfileMode"modal" | "navigation"

Controls whether clicking the "Manage your account" button will cause the UserProfile component to open as a modal, or if the browser will navigate to the userProfileUrl where UserProfile is mounted as a page.

userProfileUrl?string

The full URL or path leading to the user management interface.

afterSignOutUrl?string

The full URL or path to navigate to after a signing out from all accounts (applies to both single-session and multi-session apps)

afterMultiSessionSingleSignOutUrl?string

The full URL or path to navigate to after a signing out from currently active account (multisession apps) .

afterSwitchSessionUrl?string

Full URL or path to navigate to after a successful account change (multi-session apps).

Customization

The <UserButton/> component can be highly customized through the appearance prop and can be styled using CSS Modules, Tailwind, inline CSS objects, or global CSS.

Was this helpful?

Clerk © 2022