If your app uses embedded wallets, you can configure Privy to create wallets automatically for your users as part of their login flow.

Automatic embedded wallet creation is currently not supported if your app uses Privy’s whitelabel login interfaces. If this is the case for your app, you must manually create embedded wallets for your users at the desired point in your onboarding flow.

To configure Privy to automatically create embedded wallets for your user when they login, set the config.embeddedWallets.ethereum.createOnLogin property of your PrivyProvider:

<PrivyProvider
    appId="your-privy-app-id"
    config={{
        embeddedWallets: {
            ethereum: { 
                createOnLogin: 'users-without-wallets',
            }, 
        }, 
    }}
>
    {children}
</PrivyProvider>
createOnLogin
'all-users' | 'users-without-wallets' | 'off'
default:"off"

Determines when to create a wallet for the user.

  • 'all-users': Create a wallet for all users on login.
  • 'users-without-wallets': Create a wallet for users who do not have a wallet on login.
  • 'off': Do not create a wallet on login.