How to download state logs

Getting MetaMask Logs

To help us deliver better support, we might ask you to provide your MetaMask state logs to further analyze the issues you face. These logs tell us:

  • Your account addresses
  • Your sent transaction history
  • Your internal UI State

They don’t reveal:

  • Your Private Keys
  • Your Secret Recovery Phrase


There are four types of logs that we might ask you to provide:

State logs: MetaMask Extension

If you've had an issue sending transactions or found a visual glitch in the rendering of MetaMask, we might ask you for a state log. To get them:

  1. Open MetaMask and ensure it's unlocked
  2. Click on your Account icon on the top right corner
  3. Click on Settings and then select Advanced
  4. Click on Download State Logs
  5. Attach the file in your response on a support ticket

Screen_Shot_2021-03-03_at_9.00.28_AM.pngState logs: MetaMask Mobile

  1. In the MetaMask app, tap the Menu icon on the top left of the app
  2. Tap on Settings (gear icon)
  3. Select Advanced
  4. Scroll down and tap on "Download State Logs"
  5. Attach the file in your response on a support ticket

Popup Logs: Chrome

To get logs from the popup:

  1. Click the MetaMask fox in the top right of your browser.
  2. Wait for the popup to open (or partially open if that's part of the bug).
  3. Right-click in the newly opened popup, and select Inspect.
  4. Click Console at the top of the Inspector window.
  5. Look for any strange logs, especially red errors!
  6. Share a screenshot with us.

Background Logs: Chrome

To get logs from MetaMask's background process in Chrome:

  1. Right-click the MetaMask fox in the top right of your browser.
  2. Select Manage Extensions.

    3. Ensure "Developer Mode" is selected in the top right.

   4. Scroll down to MetaMask, and click the "Inspect views: background page" link.
   5. Click Console at the top of the Inspector window.

   6. Look for any strange logs, especially red errors!

If you are using Windows OS, usually you could see the state logs in your Downloads folder.

Crash logs: Chrome

If your bug involves crashing the whole browser, then having a browser console won't be much good! (It will be crashed).

In these cases, you'll need to start your browser in a way that it writes its logs to the disk, so you can open that log file after the browser crashes.

This process is described here, and we hope to write more specific steps on this in the future. If you have to go through this process, please do record the steps, so we can have more detailed instructions here for different platforms.

Was this article helpful?
53 out of 74 found this helpful

Articles in this section

See more
MetaMask Support on Twitter
Beware of scam Twitter accounts. Never give anyone your Secret Recovery Phrase!
MetaMask YouTube
Fow how-to and support videos please visit our channel