Reporting a Bug

Bugs can range from dice rolling incorrectly to character sheets not loading. Bug reports are a crucial part of maintaining Roll20 as well as making sure that everything works across a wide variety of setups. Our development team is always working to resolve issues that prevent and interfere with your games. Submitting a bug report is one of the best ways you can help us improve Roll20.

For reporting a bug, we first request that you prepare the report following the steps below. Once you have done so, you should attempt to reproduce the bug as you originally encountered it, taking careful notes of how you reproduced the issue. After this is complete, please fill out the Bug Report Template and pass it along to us!


Preparing a Bug Report

When creating and submitting a bug report it's important that we minimize variables that may interfere with the bug you are intending to submit. As a result, below are the steps Roll20 recommends to ensure that all reports submitted to us are consistent. 

Step 1: Verify you are using an up-to-date, supported browser.

Roll20 supports Firefox and Chrome. While Roll20 may work in a variety of browsers, Roll20 is developed and tested specifically for Firefox and Chrome. What this means is that an unsupported browser may encounter issues that we may be unable to resolve. 

Note: While many browsers are adopting the Chromium framework, we still cannot guarantee Roll20 compatibility due to possible differences in how Chromium is utilized.

Step 2: Ensure that addons/extensions are disabled.

The Roll20 interface is very sensitive to the additional, behind-the-scenes functionality that addons and extensions provide. For example, an extension may interact unexpectedly with a form field inside of a character sheet, or it may trigger a false positive with the information provided by a console log.

Here you can find instructions on how to disable addons/extensions for Chrome and Firefox.

Step 3: Clearing your cache.

Your browser automatically stores frequently-used pieces of information so that you don't have to re-download it every time you visit a website. However, if there is out-of-date or corrupted data being stored by your browser, it may load that data and cause issues. As such, we want to have a clean slate with which to work.

Here you can find instructions for clearing your cache in Chrome and Firefox.

Bug Report Template

A detailed description of the problem:

Steps to reproduce:

Description of your setup:

Most of the below information can be found here.

  • Web Browser
  • Browser Version
  • Operating System
  • If Javascript is enabled

Supplemental Information

Link to Roll20 profile:

Link to game: The URL when you're looking at your Game Details page

Screenshots/screen recordings:

List of any browser add-ons or extensions enabled:

Console log: Here you can find instructions for providing a console log in Chrome and Firefox.

Speedtest results:

Submitting the Report

Once you have completed the above steps and gathered the template information, you can send your report directly through our web form.

Was this article helpful?
70 out of 189 found this helpful