║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║

---

title: MetaMask description: Learn how to set up Web3 authentication with MetaMask.

<TutorialHero beforeYouStart={[ { title: "A Clerk application is required.", link: "/docs/getting-started/quickstart/setup-clerk", icon: "clerk", }, ]} />

Enabling MetaMask as a Web3 provider allows your users to sign in and up to your Clerk application with their MetaMask wallet.

[!IMPORTANT] MetaMask authentication is not supported when using the Clerk Chrome Extension SDK, as it cannot load third-party code per Chrome Web Store policies.

Enable MetaMask as a Web3 provider

1. In the Clerk Dashboard, navigate to the Web3 page.
2. From the list of web3 providers, enable MetaMask.
3. Download the Metamask plugin and install it on your browser to ensure a seamless login flow.

Test authentication

The simplest way to test authentication is to visit your Clerk application's Account Portal, which is available for all Clerk applications out-of-the-box.

1. In the Clerk Dashboard, navigate to the Account Portal page.
2. Next to the Sign-in URL, select Visit. The URL should resemble:
   • For development – https://your-domain.accounts.dev/sign-in
   • For production – https://accounts.your-domain.com/sign-in
3. On the sign-in page, you should see MetaMask as an option. Use it to sign in.

Collect additional user information during sign-up (optional)

Web3 applications typically use a hexadecimal wallet address to identify users, which offers a high level of privacy. However, when bridging the gap between Web3 and Web2, it's often necessary to gather human-readable information about the user, such as their email address, phone number, or a username.

To collect additional information about your user during sign-up:

1. In the Clerk Dashboard, navigate to the User & authentication page.
2. On this page, enable the attributes you want to collect from your user during sign-up.

Connect MetaMask to existing account

Users can connect their MetaMask Wallet to their account at any time through their user profile page. You can configure your application to use the Account Portal user profile page or the prebuilt <UserProfile /> component.

║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║