Skip to main content

Handling the user object

You can get information about the current user from the user object in the usePrivy hook:

const {user} = usePrivy();

For unauthenticated users, the user object will be null. For authenticated users, you can use:

  • to get their Privy DID, which you may use to identify your user on your backend
  • user.createdAt to get a JavaScript Date object of when the user was created

The user object also contains information about all of the accounts a user has linked with Privy. Use the fields:

If a user has not linked an account of a given type, the corresponding field on the user object will be undefined.

Different account types contain different information about the underlying account. For example, you might use user.wallet.address to get a user's Ethereum address and user.discord.username to get a user's Discord username. Check out the SDK Reference (linked above for each account type) to see what data each type contains.

Alternatively, you can also get a list of all the accounts a user has linked with Privy via user.linkedAccounts. Each account in this list is additionally annotated with an type field that denotes the type of account ('email', 'phone', 'wallet', etc.).

Below is an example of how you might use the user object in a minimal user profile:

Example User Profile
import {usePrivy} from '@privy-io/react-auth';

function User() {
const {ready, authenticated, user} = usePrivy();

// Show nothing if user is not authenticated or data is still loading
if (!(ready && authenticated) || !user) {
return null;

return (
<p>User {} has linked the following accounts:</p>
<li>Email: { ? : 'None' }</li>
<li>Wallet: { user.wallet ? user.wallet.address : 'None' }</li>
<li>Google: { ? : 'None' }</li>
<li>Discord: { user.discord ? user.discord.username : 'None' }</li>
<li>Twitter: { user.twitter ? user.twitter.username : 'None' }</li>
<li>Github: { user.github ? user.github.username : 'None' }</li>
<li>Phone: { ? : 'None' }</li>