How to download state logs in MetaMask

Getting MetaMask state 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

Even so, DO NOT POST YOUR LOGS PUBLICLY.

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

• State logs
• Chrome popup logs
• Chrome background logs
• Chrome crash logs

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. The following steps are for MetaMask Extension version 12.27.0 or later.

• Open MetaMask and click on the menu icon in the top right corner.

• Click on 'Settings', then 'Privacy'.

• Click on 'Download state logs'

• Attach the file in your response to a support ticket.

Mobile

1. In the MetaMask app, tap the menu icon in the top right
2. Tap 'Settings' > 'Advanced'

3. Scroll down and tap on 'Download state logs'

4. Attach the file in your response to a support ticket.

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.

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 Extension.

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.

7. Make sure you toggle "Developer Mode" back to off. Developer mode turns off a number of vital security checks, so we strongly recommend you keep it off for daily MetaMask use.

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.