Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.privy.io/llms.txt

Use this file to discover all available pages before exploring further.

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.
Automatic wallet creation only applies to login via the Privy modal and not from whitelabel login methods. It does not trigger wallet creation for users who authenticate through direct login methods like loginWithCode, useLoginWithOAuth, or similar custom flows.
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.