thirdwebDocs
GitHub

Link Profiles

When using in-app wallets or ecosystem wallets, you can link profiles to your account. This allows users to login with a frictionless method like guest, passkey or email, then later link their wallet or social profile to their account.

Once linked, users can login to their account with any of their linked profiles.

Live Playground

Try out the demo for yourself in the link profiles live playground

Try the demo

See the SDK in action on the live playground

Available auth methods

  • emailEmail
  • phonePhone
  • passkeyPasskey
  • guestGuest
  • walletWallet
  • googleGoogle
  • appleApple
  • facebookFacebook
  • xX
  • discordDiscord
  • telegramTelegram
  • twitchTwitch
  • farcasterFarcaster
  • githubGithub
  • lineLine
  • coinbaseCoinbase
  • steamSteam

Usage with UI Components

When using ConnectButton or useWalletDetailsModal, users can link a new profile by clicking the "Manage Wallet" button, as long as they are connected with an in-app or ecosystem wallet.

Usage with your own UI

You can use the useLinkProfile function to link a new profile to your account. This can be useful if you want to use a custom UI for the linking flow.

React

useLinkProfile

Hook to link a new profile to your account