AppKit FAQs

This FAQ section covers common questions and solutions for using AppKit. The questions are organized into three main categories:

Configuration: Questions about setting up AppKit, including project configuration, wallet visibility, and RPC customization.
Features: Information about AppKit’s capabilities, including off-ramp support, multi-wallet address retrieval, and branding options.
Technical: Technical details about project approval requirements and initialization constraints.

AppKit Configuration

Why am I seeing an 'Invalid App Configuration' error?

This error typically occurs when the projectId is not configured correctly. To resolve this:

Create a valid project ID at https://dashboard.reown.com/
Add it to your AppKit configuration:

const modal = createAppKit({
  ...
  projectId: "..." // Add your valid projectId here
});

Ensure that you have added your domain to the allowed domains in your project settings. If you have not done so, you can do so by navigating to “Project Domains” on the Dashboard, clicking on “Configure Domains” and adding your domain.

Why can't I see any wallets in the modal and only see the 'Connect Wallet' title?

Problem: Users only see the “Connect Wallet” title in the modal after clicking the connect button.Solution: This issue typically has two possible causes:

Version Mismatch: Ensure all @reown libraries use the same version in your package.json:

{
  "dependencies": {
    "@reown/appkit": "1.7.8",
    "@reown/appkit-adapter-wagmi": "1.7.8"
    // ... other dependencies
  }
}

Initialization Location: Call createAppKit outside of your component to ensure proper initialization:

// Create modal
createAppKit({
  adapters: [wagmiAdapter],
  ...generalConfig,
  features: {
    analytics: true // Optional - defaults to your Cloud configuration
  }
})

export function App() {
  return (
    <WagmiProvider ...>
      <QueryClientProvider ...>
        <appkit-button />
      </QueryClientProvider>
    </WagmiProvider>
  )
}

How can I use custom RPCs with AppKit?

You can use your own RPC by setting the customRpcUrls option in the AppKit configuration. This lets you define custom RPC URLs for specific chains. Each entry must follow the format:

customRpcUrls: {
  [ChainId.Ethereum]: 'https://your.custom.rpc.url',
  [ChainId.Polygon]: 'https://your.polygon.rpc.url'
}

AppKit will prioritize these URLs over the default ones.

Features

When will Reown support off-ramp functionality?

How do I get retrieve multiple addresses from multiple connected wallets?

To retrieve addresses from multiple connected wallets, refer to our multichain example:

Example using React SDK:

import { useAppKitAccount } from '@reown/appkit/react'

// Get account states for different chains
const eip155AccountState = useAppKitAccount({ namespace: 'eip155' })
const solanaAccountState = useAppKitAccount({ namespace: 'solana' })

<>
  EVM Address: {eip155AccountState.address}<br />
  Solana Address: {solanaAccountState.address}<br />
</>

How do I remove the 'UX by Reown' branding?

How do I increase my project's RPC limits?

Technical

Do I need to wait for Web3 app approval before using my projectId?

Can I reinitialize AppKit with different network configurations?

Error Codes

Below is a list of error codes you may encounter when using AppKit, along with their descriptions and recommended actions:

Code	Message	Action
APKT001	Network Not Found	We couldn’t recognize the specified network. Make sure it’s included in the `networks` array of your `createAppKit` config.
APKT002	Invalid App Configuration	The origin isn’t in your allowlist. Update your allowed domains at https://dashboard.reown.com.
APKT003	Wallet Load Failed	We couldn’t load the embedded wallet. This might be a network or server issue. Check your connection and try again, or contact support if it persists.
APKT004	Wallet Request Timeout	The wallet didn’t respond in time. Check your network and try again. If the issue continues, contact support.
APKT005	Unverified Domain	The embedded wallet didn’t load. Please verify your domain at https://dashboard.reown.com.
APKT006	Session Expired	Your session has expired or is invalid. Please check your device’s date and time, then reconnect.
APKT007	Invalid Project ID	The project ID is invalid. You can find or create a valid one at https://dashboard.reown.com.
APKT008	Project ID Missing	No project ID was found. Set one up in your config at https://dashboard.reown.com.
APKT009	Server Error	We couldn’t load your App Configuration. Check your network and try again. Contact support if it keeps happening.
APKT010	Rate Limited	Too many requests for App Configuration. Please wait a few minutes and try again. Reach out to support if needed.

Support

How do I get technical support for AppKit?

Getting Started

Paid Plans

Features

Authentication

Integrations

Payments

Network

Guides

Upgrade

Migration

Technical Reference

AppKit Configuration

Features

Technical

Support

Getting Started

Paid Plans

Features

Authentication

Integrations

Payments

Network

Guides

Upgrade

Migration

Technical Reference

​AppKit Configuration

​Features

​Technical

​Support

AppKit Configuration

Features

Technical

Support