> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dynamic.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Personal Subdomains

<Card title="Recommended: JavaScript SDK with React Hooks" icon="react" color="#4779FE">
  For new React apps, we recommend the JavaScript SDK with React Hooks (`@dynamic-labs-sdk/react-hooks`) instead of the legacy React SDK documented here. The JS SDK comes with many benefits such as a much smaller bundle size and other optimizations. Use the [React quickstart (JavaScript SDK)](/javascript/reference/react-quickstart) to get started.
</Card>

<Note>
  Global Identity is only available for EVM
  [embedded wallets](/overview/wallets/embedded-wallets/mpc/overview)
  on [V4](/react/reference/upgrade/v4) of the Dynamic SDK.
</Note>

## Overview

Global Identity allows your users to select personal subdomains for their wallets,
tied to one main domain name. These subdomains function as unique identifiers associated with that
user's wallet address.

A user's subdomain will look like this: `custom-subdomain.main-domain.eth`

## Configuration

To enable personalized subdomains, you must first set up your main domain name in the
[Embedded Wallets](https://app.dynamic.xyz/dashboard/embedded-wallets/dynamic) section of the Dynamic Dashboard.

1. Enable the "Personalized Subdomains" toggle and open the drawer.
2. Use the pre-populated ENS domain name associated with your primary wallet or manually enter one.

<Frame>
  <img src="https://mintcdn.com/dynamic-docs/DXbjtpFZjzIwv2VQ/images/dashboard/dashboard-global-identities-setup.png?fit=max&auto=format&n=DXbjtpFZjzIwv2VQ&q=85&s=b65225aa648ea9073b5ff54de75388de" width="1362" height="1488" data-path="images/dashboard/dashboard-global-identities-setup.png" />
</Frame>

3. Click "Verify and Continue" and sign the message from Namestone to verify your domain. Make sure that
   your primary wallet (in the top right corner of the dashboard) is the wallet associated with your domain.

<Frame>
  <img src="https://mintcdn.com/dynamic-docs/DXbjtpFZjzIwv2VQ/images/dashboard/dashboard-global-identities-wallet-check.png?fit=max&auto=format&n=DXbjtpFZjzIwv2VQ&q=85&s=57c9b6703e92c422ac1c10ff1db92da0" width="1432" height="920" data-path="images/dashboard/dashboard-global-identities-wallet-check.png" />
</Frame>

4. Once your domain is verified, you can close the drawer and click "Save" to enable personalized subdomains.

### Require Subdomains

The require subdomains toggle will ask your users to choose a subdomain when they sign up or register with a new wallet.

<Frame>
  <img src="https://mintcdn.com/dynamic-docs/S0I4gBjjMnJYbuz8/images/widget/widget-global-identities-onboarding.png?fit=max&auto=format&n=S0I4gBjjMnJYbuz8&q=85&s=c46f3949000a8f678e83f754269b4486" width="300" data-path="images/widget/widget-global-identities-onboarding.png" />
</Frame>

## Choosing subdomains

Users can view and change their subdomain in the Profile section of the DynamicWidget:

<Tabs>
  <Tab title="User Profile">
    <Frame>
      <img src="https://mintcdn.com/dynamic-docs/S0I4gBjjMnJYbuz8/images/widget/widget-global-identities-profile.png?fit=max&auto=format&n=S0I4gBjjMnJYbuz8&q=85&s=5a2996418936f6092e59d8259a75d48f" width="300" data-path="images/widget/widget-global-identities-profile.png" />
    </Frame>
  </Tab>

  <Tab title="Edit Profile">
    <Frame>
      <img src="https://mintcdn.com/dynamic-docs/S0I4gBjjMnJYbuz8/images/widget/widget-global-identities-profile-edit.png?fit=max&auto=format&n=S0I4gBjjMnJYbuz8&q=85&s=7cb0069776a2b89e78fb3571e2eb93ab" width="300" data-path="images/widget/widget-global-identities-profile-edit.png" />
    </Frame>
  </Tab>
</Tabs>