Options

The following options can be passed to the createAppKit function:

createAppKit({ adapters, projectId, networks, ...options });

​

networks

Array of networks that can be chosen from the @reown/appkit/networks library. This library retrieves the list of EVM networks from Viem and also includes the Solana networks.

import { mainnet, solana } from "@reown/appkit/networks";

createAppKit({
  // ...
  networks: [mainnet, solana],
});

For custom networks, refer to this doc page.

​

metadata

Metadata for your AppKit. The name, description, icons, and url are used at certain places like the wallet connection, sign message, etc screens. If not provided, they will be fetched from the metadata of your website’s document object.

createAppKit({
  // ...
  metadata: {
    name: "My App",
    description: "My App Description",
    icons: ["https://myapp.com/icon.png"],
    url: "https://myapp.com",
  },
});

For custom networks, refer to this doc page.

​

defaultNetwork

Desired network for the initial connection as default:

import { mainnet } from "@reown/appkit/networks";

createAppKit({
  //...
  defaultNetwork: mainnet,
});

import { mainnet } from "@reown/appkit/networks";

createAppKit({
  //...
  defaultNetwork: mainnet,
});

const mainnet = {
  chainId: 1,
  name: "Ethereum",
  currency: "ETH",
  explorerUrl: "https://etherscan.io",
  rpcUrl: "https://cloudflare-eth.com",
};

createAppKit({
  //...
  defaultNetwork: mainnet,
});

import { solana } from "@reown/appkit/networks";

createAppKit({
  //...
  defaultNetwork: solana,
});

​

defaultAccountTypes

It allows you to configure the default account selected for the specified networks in AppKit. For example, if you want your EVM networks to use an EOA account by default, you can configure it as shown in the code below.

createAppKit({
  //...
  defaultAccountTypes: { eip155: "eoa" },
});

Here are all the options you have for each network identifier or networks. Network identifier or networks available are eip155 for EVM chains, solana for Solana, bip122 for Bitcoin, and polkadot for Polkadot.

type DefaultAccountTypes = {
  eip155: "eoa" | "smartAccount";
  solana: "eoa";
  bip122: "payment" | "ordinal" | "stx";
  polkadot: "eoa";
};

​

featuredWalletIds

Select wallets that are going to be shown on the modal’s main view. Default wallets are MetaMask and Trust Wallet. Array of wallet ids defined will be prioritized (order is respected). These wallets will also show up first in All Wallets view. You can find the wallets IDs in Wallets List or in WalletGuide

createAppKit({
  //...
  featuredWalletIds: [
    "1ae92b26df02f0abca6304df07debccd18262fdf5fe82daa81593582dac9a369",
    "4622a2b2d6af1c9844944291e5e7351a6aa24cd7b23099efac1b2fd875da31a0",
  ],
});

​

chainImages

Add or override the modal’s network images.

createAppKit({
  // ...
  chainImages: {
    1: "https://my.images.com/eth.png",
  },
});

​

connectorImages

createAppKit({
  connectorImages: {
    coinbaseWallet: "https://images.mydapp.com/coinbase.png",
    metaMask: "https://images.mydapp.com/metamask.png",
  },
});

createAppKit({
  connectorImages: {
    coinbaseWallet: "https://images.mydapp.com/coinbase.png",
    metaMask: "https://images.mydapp.com/metamask.png",
  },
});

createAppKit({
  connectorImages: {
    coinbaseWallet: "https://images.mydapp.com/coinbase.png",
    walletConnect: "https://images.mydapp.com/walletconnect.png",
  },
});

createAppKit({
  connectorImages: {
    coinbaseWallet: "https://images.mydapp.com/coinbase.png",
    phantom: "https://images.mydapp.com/phantom.png",
    walletConnect: "https://images.mydapp.com/walletconnect.png",
  },
});

​

enableWalletConnect

Enable or disable WalletConnect QR feature. Default is true.

enableWalletConnect: false;

​

enableNetworkSwitch

Enables or disables the network switching functionality in the modal. The default is true.

createAppKit({
  //...
  enableNetworkSwitch: false,
});

​

debug

Enable or disable debug mode in your AppKit. This is useful if you want to see UI alerts when debugging. Default is false.

debug: true;

​

enableWalletGuide

Enable or disable the wallet guide text, is useful for people that don’t have a wallet yet. Default is true.

createAppKit({
  //...
  enableWalletGuide: false,
});

​

termsConditionsUrl

You can add an url for the terms and conditions link.

createAppKit({
  //...
  termsConditionsUrl: "https://www.mytermsandconditions.com",
});

​

privacyPolicyUrl

A URL for the privacy policy link.

createAppKit({
  //...
  privacyPolicyUrl: "https://www.myprivacypolicy.com",
});

​

features

Allows you to toggle (enable or disable) additional features provided by AppKit. Features such as analytics, email and social logins, On-ramp, swaps, etc., can be enabled using this parameter.

​

analytics

Enable analytics to get more insights on your users activity within your Reown Cloud’s dashboard

createAppKit({
  //...
  features: {
    analytics: true,
  },
});

​

swaps

Enable or disable the swap feature in your AppKit. Swaps feature is enabled by default.

createAppKit({
  //...
  features: {
    swaps: true,
  },
});

​

onramp

Enable or disable the onramp feature in your AppKit. Onramp feature is enabled by default.

createAppKit({
  //...
  features: {
    onramp: true,
  },
});

​

connectMethodsOrder

Order of the connection methods in the modal. The default order is ['wallet', 'email', 'social'].

createAppKit({
  //...
  features: {
    connectMethodsOrder: ["social", "email", "wallet"],
  },
});

​

legalCheckbox

Enable or disable the terms of service and/or privacy policy checkbox.

createAppKit({
  //...
  features: {
    legalCheckbox: true,
  },
});

​

customWallets

Adds custom wallets to the modal. customWallets is an array of objects, where each object contains specific information of a custom wallet.

createAppKit({
  //...
  customWallets: [
    {
      id: "myCustomWallet",
      name: "My Custom Wallet",
      homepage: "www.mycustomwallet.com", // Optional
      image_url: "my_custom_wallet_image", // Optional
      mobile_link: "mobile_link", // Optional - Deeplink or universal
      desktop_link: "desktop_link", // Optional - Deeplink
      webapp_link: "webapp_link", // Optional
      app_store: "app_store", // Optional
      play_store: "play_store", // Optional
    },
  ],
});

​

AllWallets

The allWallets parameter allows you to add or remove the “All Wallets” button on the modal.

createAppKit({
  //...
  allWallets: "ONLY_MOBILE",
});

​

includeWalletIds & excludeWalletIds

​

includeWalletIds

Override default recommended wallets that are fetched from WalletGuide. Array of wallet ids defined will be shown (order is respected). Unlike featuredWalletIds, these wallets will be the only ones shown in All Wallets view and as recommended wallets. You can find the wallets IDs in our Wallets List.

createAppKit({
  //...
  includeWalletIds: [
    "1ae92b26df02f0abca6304df07debccd18262fdf5fe82daa81593582dac9a369",
    "4622a2b2d6af1c9844944291e5e7351a6aa24cd7b23099efac1b2fd875da31a0",
  ],
});

​

excludeWalletIds

Exclude wallets that are fetched from WalletGuide. Array of wallet ids defined will be excluded. All other wallets will be shown in respective places. You can find the wallets IDs in our Wallets List.

createAppKit({
  //...
  excludeWalletIds: [
    "1ae92b26df02f0abca6304df07debccd18262fdf5fe82daa81593582dac9a369",
    "4622a2b2d6af1c9844944291e5e7351a6aa24cd7b23099efac1b2fd875da31a0",
  ],
});

​

Coinbase Smart Wallet

The Coinbase connector now includes a new flag to customize the Smart Wallet behavior.

The preference (or coinbasePreference) flag accepts one of the following string values:

• eoaOnly: Uses EOA Browser Extension or Mobile Coinbase Wallet.
• smartWalletOnly: Displays Smart Wallet popup.
• all (default): Supports both eoaOnly and smartWalletOnly based on context.

createAppKit({
  //...
  enableCoinbase: true, // true by default
  coinbasePreference: "smartWalletOnly",
});

createAppKit({
  //...
  enableCoinbase: true, // true by default
  coinbasePreference: "smartWalletOnly",
});

createAppKit({
  //...
  enableCoinbase: true, // true by default
  coinbasePreference: "smartWalletOnly",
});

​

customRpcUrls

This function allows you to add custom RPC URLs to override the default network RPC URLs for native RPC calls. This is useful when you want to use your own RPC endpoints instead of the defaults.

type CustomRpcUrl = {
  url: string
  config?: HttpTransportConfig // Optional transport configuration
}

type CustomRpcUrlMap = Record<CaipNetworkId, CustomRpcUrl[]>

createAppKit({
  //...
  customRpcUrls: {
    'eip155:1': [
      {
        url: 'https://your-custom-mainnet-url.com',
        config: {
          // Optional HTTP transport configuration
        }
      }
    ],
    'eip155:137': [
      {
        url: 'https://your-custom-polygon-url.com'
      }
    ]
  }
})

If you are using the Wagmi adapter, you need to pass the same customRpcUrls configuration to both the WagmiAdapter and createAppKit.

const customRpcUrls: CustomRpcUrlMap = {
  'eip155:1': [{ url: 'https://your-custom-mainnet-url.com' }],
  'eip155:137': [{ url: 'https://your-custom-polygon-url.com' }]
}

const wagmiAdapter = new WagmiAdapter({
  networks: [...],
  projectId: "project-id",
  customRpcUrls
})

const modal = createAppKit({
  adapters: [...],
  networks: [...],
  projectId: "project-id",
  customRpcUrls
})

const wagmiAdapter = new WagmiAdapter({
  //...
  customRpcUrls: {
    'eip155:1': [{ url: 'https://custom-rpc-1.com' }] // This will be overridden
  },
  transports: {
    [mainnet.id]: http('https://transport-rpc-1.com') // This takes precedence
  }
})

​

universalProviderConfigOverride

Lets you customize specific aspects of the provider’s behavior.

createAppKit({
  //...
  universalProviderConfigOverride: {
    methods: { eip155: ['eth_sendTransaction', 'personal_sign'] },
    chains: { eip155: ['1', '137'] },
    events: { eip155: ['chainChanged', 'accountsChanged'] },
    rpcMap: { eip155:1: 'https://ethereum.publicnode.com' },
    defaultChain: 'eip155:1'
  },
});

You can override any of the following properties:

• methods: Custom RPC methods for each namespace
• chains: Supported chains for each namespace
• events: Events to subscribe to for each namespace
• rpcMap: Custom RPC URLs for specific chains
• defaultChain: The default chain to connect to