Unfortunately, bugs happen. As much as we try, it's impossible to make your software 100% bug-proof. So, in case something doesn't work or you experience board loading issues, this article has a few tips for you to learn how to report the bug in the most effective way.
Before reporting a bug, try these troubleshooting steps
- Test Miro in the Incognito (private) mode (to exclude the possibility of browser extensions interfering) and in a different browser. Close all browser tabs and applications running in the background if needed.
- Clear your browser's cache & cookies, restart your browser and hard refresh the page by clicking F5 (or Ctrl / Cmd + R) several times.
- Check your Internet connection or switch to another, preferably faster network. Feel free to try different VPNs if necessary to avoid any security blockers in your network.
- If you use desktop / mobile application, try to re-install it and test Miro using a web-version.
- Sign out and back into your Miro profile and see if that helps.
- If you experience problems with specific boards, try to duplicate them and check if the problem persists there. Also, feel free opening a smaller in size or relatively empty board in Miro to see how the performance changes there.
All of this helps to either start a new working session and ensure you are using the latest client version or check whether the issue is caused by / connected with something in your setup.
If the recommendations above didn't help, contact Miro Support: please check this article to learn how you can do this. We'd highly appreciate if you spend some time reading this article, so we can get as detailed as possible request and help you promptly. Thank you!
Submitting a bug
There are a few things you can do that will help us identify and fix the bug quicker:
1. Add the word "bug" to the subject
It's a little thing, but it helps us spot these tickets in the queue and reply to them faster.
Example: "Bug in the Links edit menu"
2. Include a detailed description of the bug
Tell us what the bug is about and describe the steps to reproduce it. Here is a good example of a bug report:
1. Open any board, click Share.
2. Add the email addresses of collaborators.
3. Click Send.
4. Expectations: the board shows the message "Invitations sent" and the collaborators receive an invitation to edit the board.
5. Reality: the message is shown, but none of the collaborators received an invitation.
2a. Include the board URL
If the issue or a bug is board-related (happens only on specific boards) the link will be of huge help.
- duplicate the board and check whether the bug also happens on the copy or only on the original board
- if the bug is not seen right away and requires steps to reproduce it - share the board (with editing rights) with firstname.lastname@example.org
- if the bug occurs on specific boards and is only seen by specific collaborators - please also list the email addresses of the affected collaborators.
This information saves a lot of time and effort when investigating the bug.
2b. Specify the device, OS, and browser version
Let us know the device, OS, and browser version you were using when the bug occurred.
3. Send screenshots, GIFs, or a short video
3a. Provide your browser console logs
- While on the Miro board click the address bar of your browser (use this step if the issue is reproduced on a board):
- Press F12 or fn + F12 shortcut to open the browser developer tools.
- Choose Network tab, check to Preserve logs.
- Reload the page.
- Try to reproduce the issue again.
- Click the Download Arrow sign to Export the Network HAR logs.
- Then switch to the Console tab and right-click the records and choose to Save as.
- Send us the 2 resulting .log and .har files.