# Mobile Best Practices

If this page doesn't answer your question, please feel free to open an issue in our repository.

# The Provider (window.ethereum)

The provider API is the same for both MetaMask mobile and the desktop extension. However, the providers become available (i.e., are injected into the page) at different points in the page lifecycle.

# Provider Availability

If you use @metamask/detect-provider, there's nothing to worry about; it will reliably detect both the mobile and extension provider.

If you don't use the detect-provider package, you have to detect the mobile provider manually.

The extension provider will always be available by the time your code is executed. Because of platform limitations, the mobile provider may not be injected until later in the page lifecycle. For this purpose, the MetaMask provider dispatches the event ethereum#initialized on window when it is fully initialized.

You can reliably detect both the mobile and extension provider with the following snippet.

if (window.ethereum) {
} else {
  window.addEventListener('ethereum#initialized', handleEthereum, {
    once: true,
  // If the event is not dispatched by the end of the timeout,
  // the user probably doesn't have MetaMask installed.
  setTimeout(handleEthereum, 3000); // 3 seconds
function handleEthereum() {
  const { ethereum } = window;
  if (ethereum && ethereum.isMetaMask) {
    console.log('Ethereum successfully detected!');
    // Access the decentralized web!
  } else {
    console.log('Please install MetaMask!');