> For the complete documentation index, see [llms.txt](/llms.txt).

# useWalletUI

Hook to show the Wallet Services UI modal using the Wallet Services plugin.

info

Please note that this hook doesn't work for external wallet logins. It only works for social login embedded wallets.

### Import

```tsx
import { useWalletUI } from '@web3auth/modal/react'

```

### Usage

```tsx
import { useWalletUI } from '@web3auth/modal/react'

function WalletUIButton() {
  const { showWalletUI, loading, error } = useWalletUI()

  return (
    <div>
      <button onClick={() => showWalletUI()} disabled={loading}>
        {loading ? 'Opening Wallet UI...' : 'Show Wallet UI'}
      </button>
      {error && <div>{error.message}</div>}
    </div>
  )
}

```

### Return type

```tsx
import { type IUseWalletUI } from '@web3auth/modal/react'

```

#### `loading`

`boolean`

Whether the Wallet UI opening process is in progress.

#### `error`

`Web3AuthError | null`

Error that occurred during the Wallet UI opening process.

#### `showWalletUI`

`(showWalletUiParams?: BaseEmbedControllerState["showWalletUi"]) => Promise<void>`

Function to show the Wallet Services modal UI. Accepts optional parameters for customizing the wallet UI experience.