Custom Chains

By default, we only surface Ethereum Mainnet. If you'd like, you can include more networks like Optimism, Polygon, and others.

ConnectKit uses wagmi internally, meaning all the various chains from wagmi are available. All you need to do is provide a custom wagmi config.

First, make sure to import your preferred chains from wagmi:

import { mainnet, polygon, optimism, arbitrum } from "wagmi/chains";

Then simply replace the default config provided to wagmi with a custom one. Make sure to include your own Infura or Alchemy IDs for the various connectors you want to support.

Below is an example of an app supporting multiple chains/networks using ConnectKit:

import { WagmiConfig, createConfig, chain } from "wagmi";
import { ConnectKitProvider, getDefaultConfig } from "connectkit";

const alchemyId = process.env.ALCHEMY_ID;
const walletConnectProjectId = process.env.WALLETCONNECT_PROJECT_ID;

// Choose which chains you'd like to show
const chains = [mainnet, polygon, optimism, arbitrum];

const config = createConfig(
  getDefaultConfig({
    appName: "Your App Name",
    alchemyId,
    walletConnectProjectId,
    chains,
  }),
);

const App = () => {
  return (
    <WagmiConfig config={config}>
      <ConnectKitProvider>
        {/* Your App */}
        <ConnectKitButton />
      </ConnectKitProvider>
    </WagmiConfig>
  );
};

And that's it—users can now choose to connect to any of the networks listed in the chains array.

In the example above, we used four different chains. In the table below you'll find a more extensive list of chains you can add to ConnectKit (which wagmi supports out of the box):