Powered by

A design system from Family

Custom Chains

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

Example

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:

,
CustomChains.jsx
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:

,
CustomChains.jsx
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.

Chains & Networks

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):

IconIDChainSymbolName
1mainnetETHEther
5goerliETHGoerli Ether
10optimismETHEther
14flareFLRflare
16songbirdTestnetCFLRcostonflare
19songbirdSGBsongbird
25cronosCROCronos
40telosTLOSTelos
41telosTestnetTLOSTelos
50xdcXDCXDC
51xdcTestnetTXDCTXDC
56bscBNBBNB
57syscoinSYSSyscoin
66okcOKTOKT
97bscTestnettBNBBNB
100gnosisxDAIGnosis
114flareTestnetC2FLRcoston2flare
137polygonMATICMATIC
250fantomFTMFantom
280zkSyncTestnetETHEther
288bobaBOBABoba
314filecoinFILfilecoin
324zkSyncETHEther
369pulsechainPLSPulse
420optimismGoerliETHGoerli Ether
599metisGoerliMETISMetis Goerli
841taraxaTARATara
842taraxaTestnetTARATara
888wanchainWANWANCHAIN
943pulsechainV4PLSPulse
997thunderTestnet5IRE5ire Token
999wanchainTestnetWANtWANCHAIN
1038bronosTestnettBROBronos Coin
1039bronosBROBRO
1088metisMETISMetis
1101polygonZkEvmETHEther
1284moonbeamGLMRGLMR
1285moonriverMOVRMOVR
1287moonbaseAlphaDEVDEV
1337localhostETHEther
1442polygonZkEvmTestnetETHEther
2000dogechainDCDogechain
3141filecoinHyperspacetFILtestnet filecoin
3737crossbellCSBCSB
4002fantomTestnetFTMFantom
4242nexiNEXINexi
4689iotexIOTXIoTeX
4690iotexTestnetIOTXIoTeX
7700cantoCANTOCanto
8082shardeumSphinxSHMSHARDEUM
8217klaytnKLAYKlaytn
9000evmosTestnetEVMOSEvmos
9001evmosEVMOSEvmos
10200gnosisChiadoxDAIGnosis
11235haqqMainnetISLMIslamic Coin
17323celoCannoliC-CELOCELO
31337foundryETHEther
31337hardhatETHEther
42161arbitrumETHEther
42220celoCELOCELO
43113avalancheFujiAVAXAvalanche Fuji
43114avalancheAVAXAvalanche
44787celoAlfajoresA-CELOCELO
53935dfkJEWELJewel
54211haqqTestedge2ISLMTIslamic Coin
59140lineaTestnetETHLinea Ether
80001polygonMumbaiMATICMATIC
84531baseGoerliETHBase Goerli
314159filecoinCalibrationtFILtestnet filecoin
421613arbitrumGoerliETHArbitrum Goerli Ether
534353scrollTestnetETHEther
1337803zhejiangZhejETHZhejiang Ether
11155111sepoliaSEPSepolia Ether
278611351skaleRazorsFUELsFUEL
344106930skaleCalypsoTestnetsFUELsFUEL
391845894skaleBlockBrawlersBRAWLBRAWL
476158412skaleEuropaTestnetsFUELsFUEL
503129905skaleNebulaTestnetsFUELsFUEL
1026062157skaleCryptoBladessFUELsFUEL
1273227453skaleHumanProtocolsFUELsFUEL
1313161554auroraETHEther
1313161555auroraTestnetETHEther
1350216234skaleTitansFUELsFUEL
1351057110skaleChaosTestnetsFUELsFUEL
1482601649skaleNebulasFUELsFUEL
1517929550skaleTitanTestnetsFUELsFUEL
1564830818skaleCalypsosFUELsFUEL
1666600000harmonyOneONEHarmony
2046399126skaleCryptoColosseumsFUELsFUEL
2046399126skaleEuropasFUELsFUEL
2139927552skaleExordesFUELsFUEL