Troubleshooting Guide

Start Here: Quick Diagnosis Checklist

Before deep-diving, confirm all five of these are true. Most issues come down to one of them:

• Beyond20 is installed and enabled in your browser
• https://www.owlbear.rodeo/* is in Beyond20's custom domains list (the single most common missed step)
• Owl20 browser extension is installed and enabled in your browser
• The DM has the Owl20 OBR extension enabled in their Owlbear Rodeo room
• Both D&D Beyond and Owlbear Rodeo tabs have been refreshed since the extensions were installed

If any of these are false, fix it first before reading further. Most issues are resolved by #2 alone.

Dice Rolls Not Appearing in Owlbear Rodeo

Work through these in order. Each check builds on the previous one.

1. Check Beyond20 is installed and active

Open your browser's extension manager:

• Chrome: Navigate to chrome://extensions
• Edge: Navigate to edge://extensions
• Firefox: Navigate to about:addons

Find Beyond20 in the list and confirm the toggle is ON. If it's not installed, install it first: beyond20.here-for-more.info/install.

2. Check the Beyond20 custom domain — this is the most common issue

Open your D&D Beyond character sheet and click the Beyond20 icon in the toolbar. Navigate to More Options → Advanced Options and look for the "List of custom domains to load Beyond20" field. It must contain:

Without this entry, Beyond20 won't activate on Owlbear Rodeo pages, which means Owl20 receives no roll data to bridge. Add it, save, and refresh both tabs.

3. Check the Owl20 browser extension

In your browser's extension manager, find Owl20 and confirm it's enabled. If it was recently installed, try disabling and re-enabling it. Then refresh your Owlbear Rodeo tab.

4. Check the DM has the OBR extension enabled

As a player, you can't enable the Owlbear Rodeo-side extension — only the DM can. The DM needs to:

1. Open the Owlbear Rodeo room
2. Click the Extensions button in the toolbar
3. Find Owl20 and toggle it ON

If the DM hasn't set this up yet, point them to the DM Setup Guide.

5. Reload both tabs

Close your D&D Beyond tab entirely and reopen it. Then close your Owlbear Rodeo tab and reopen it. This forces both extensions to reinitialize from scratch. Don't just press F5 — fully close and reopen the tabs.

6. Check the browser console for Owl20 messages

On your Owlbear Rodeo tab, press F12 to open Developer Tools, click the Console tab, and look for messages starting with Owl20:.

Healthy output looks like:

• Owl20: Initializing data bridge
• Owl20: Found iframe to owl20-owlbear
• Owl20: Listening for Beyond20 roll events

If you see no Owl20 messages: the extension isn't loading on this page. Check that it's enabled in your browser extension manager and that you're on an owlbear.rodeo URL (not a local file or different domain).

If you see red error messages: copy the error text and search the FAQ or post it in the GitHub Issues.

7. Check for ad blockers or privacy extensions

Aggressive ad blockers (uBlock Origin with strict settings, Privacy Badger, etc.) can block the extension's cross-origin messaging. Try temporarily disabling all other browser extensions while on both owlbear.rodeo and dndbeyond.com. If rolls start working with other extensions disabled, add an exception for both domains in your ad blocker settings.

Extension Not Loading At All

If Owl20 doesn't appear in your browser extension manager or won't install:

Browser compatibility

Owl20 supports Chrome, Edge, and Firefox. It will also work on any Chromium-based browser (like Brave or Opera) that supports Manifest V3 extensions.

If you're using Safari, Internet Explorer, or an older pre-Manifest V3 browser, Owl20 is not supported on those platforms.

Browser is out of date

Manifest V3 extensions require a relatively recent browser version. Check for updates:

• Chrome: chrome://settings/help
• Edge: edge://settings/help
• Firefox: Menu → Help → About Firefox

Try a full disable/re-enable cycle

1. Go to your browser's extension manager
2. Find Owl20 and toggle it OFF
3. Wait 5 seconds
4. Toggle it back ON
5. Refresh your Owlbear Rodeo tab

Check extension permissions

Owl20 needs access to owlbear.rodeo domains. In your browser extension manager, click on Owl20 and review its site permissions. If access was denied or restricted, grant it.

Full browser restart

Close all browser windows completely (not just tabs) and reopen. This clears cached extension states. On Windows, make sure the browser isn't still running in the system tray.

Browser-Specific Notes

Google Chrome

Chrome is the most tested browser for Owl20. If you're having issues on Chrome specifically:

• Check that Chrome is updated to at least version 110
• Make sure you haven't accidentally set Owl20 to "Allow in Incognito only" — it needs to run in regular windows where D&D Beyond is open
• If using a work or school Chrome profile, extensions may be restricted by policy

Microsoft Edge

Edge uses the same Manifest V3 system as Chrome, so compatibility is generally the same. One Edge-specific note:

• Edge has an "Enhanced Security" mode that may block extension cross-origin messaging. If you have this enabled, add owlbear.rodeo to Edge's "Sites that can bypass Enhanced Security" exceptions.

Mozilla Firefox

Firefox uses a slightly different extension model. If Owl20 isn't working in Firefox:

• Confirm you installed from addons.mozilla.org (not a third-party source)
• Firefox's stricter content security policies can sometimes interfere with extension messaging. If you have a custom user.js or use Firefox Hardened, try with a fresh profile to isolate the issue.

Opera and other Chromium browsers

Owl20 can be installed on Opera via the Chrome Web Store using the "Install Chrome Extensions" option. Opera-specific issue: Opera's integrated ad blocker may need to be disabled on both owlbear.rodeo and dndbeyond.com.

Mobile browsers

Owl20 does not support mobile browsers. Browser extensions are not available on iOS or Android. Both D&D Beyond and Owlbear Rodeo must be accessed from a desktop browser.

Rolls Delayed or Appearing Intermittently

If rolls sometimes appear and sometimes don't, or there's a noticeable delay:

Tab was open before extension was enabled

If you had Owlbear Rodeo open before the DM enabled the extension, you may need to refresh your tab. The extension initializes when the page loads, not when it's toggled on mid-session.

Multiple Owlbear Rodeo tabs open

If you have multiple Owlbear Rodeo tabs open simultaneously, Owl20 runs in each one independently. Rolls will appear in the tab where the Owl20 OBR extension is active. Close extra tabs and work from a single Owlbear Rodeo tab.

Browser resource limits

If your browser has many tabs open and is under memory pressure, extension messaging can be delayed. Closing unused tabs may help.

Still Having Issues?

If you've worked through all the above and still can't get Owl20 working:

Check the FAQ first

The FAQ page covers 33 specific questions including browser support details, permission explanations, and more niche setup scenarios.

Report a bug on GitHub

If you think you've found a bug, open an issue at github.com/uberdragon/owl20/issues. When reporting, include:

• Your browser and version
• Your Beyond20 version
• What you expected to happen vs what actually happened
• Any Owl20: messages from the browser console (F12 → Console)
• Any red error messages from the console

Ask on Discord

Join the Starry Shores Discord and ask for DM UberDragon or DM Sparks. We're both active in the server and usually respond within a day. We both run this setup ourselves every session, so we can work through most issues quickly.

The more information you bring to the conversation — browser, console output, what step fails — the faster we can help.