A Firefox for Android extension that removes Reddit's “Get the app to keep using Reddit” prompts and gives back scrolling and taps.
Install · Changelog · Privacy policy · Report an issue
- Hides Reddit's blocking app prompts (bottom sheets, full-screen sheets and dialogs) before they are drawn.
- Restores the scrolling, taps and swipes that a prompt locks.
- Leaves Reddit's ordinary dialogs, such as cookie consent and login, working.
- Works in every language: prompts are recognized by their components, not their text.
- Shows whether the current tab is protected and how many prompts have been blocked.
Install it in Firefox for Android 144 or later from Firefox Add-ons. If Firefox asks, allow access to Reddit's sites, then reload open Reddit tabs.
The extension collects and transmits no data and makes no network requests of its
own. It runs only on HTTPS pages of reddit.com, www.reddit.com, m.reddit.com
and sh.reddit.com; besides access to those sites, its only permission is
storage, which keeps the blocked-prompt count on the device. It does not read or
clear cookies, touch logins, or change the user agent. Details are in the
privacy policy.
A page script runs at document_start in the page's MAIN world, because it has
to wrap the page's own preventDefault and attachShadow before Reddit's scripts
run; it has no access to extension APIs. It:
- Hides known promotion components by id, element name and class with user-origin CSS, which also reaches closed shadow roots.
- Dismisses prompts through Reddit's own
configured-xpromo-modal, sending it the event Reddit uses to close them, so prompts with an unknown identity close too. - Unlocks the page roots (lock classes, blocking inline styles and
inert), unless an ordinary dialog is open. - Releases gestures by ignoring
preventDefault()from page-leveltouchmove/wheellisteners after a prompt, except on form controls, sliders and canvas, for multitouch, and while an ordinary dialog is open. - Sets Reddit's
localStorage["xpromo-consolidation"]to the current date, as uBlock Origin's filter does. The value stays after uninstalling.
Only inserted or changed elements are inspected, and unlocking runs at most once per animation frame.
- It relies on Reddit's component names and may need an update when Reddit changes them. Reddit tests prompt variants on subsets of users, so not every variant can be observed.
Open an issue with the Reddit URL, your Firefox and extension versions, whether the popup shows the tab as protected, and a screenshot of the prompt.
Requires Node.js 24+, Python 3, and Firefox 144+ with geckodriver, found in PATH,
through FIREFOX_BINARY and GECKODRIVER, or in the Selenium cache.
npm ci
npm run check # web-ext lint, unit tests, browser tests on local fixtures
npm run build # reproducible dist/reddit-mobile-unblocker-<version>-unsigned.xpi
npm run release # checks, then the package, source archive and checksums for AMO
npm start # load the extension temporarily in desktop FirefoxTo run the source on a phone, enable USB debugging and Firefox's “Remote debugging
via USB”, connect it, find its ID with adb devices, and run:
npm run start:android -- --android-device=DEVICE_ID --firefox-apk=org.mozilla.firefoxUse org.mozilla.firefox_beta for Beta and org.mozilla.fenix for Nightly
(Mozilla's guide).
npm run test:live checks the extension on real Reddit pages, in Firefox emulating
a phone or, with --android, on a connected phone. Reddit's own components open a
prompt, both immediately and through Reddit's 30-second timer: without the
extension the prompt must block the page, with it the page must stay usable.
Screenshots and report.json go to live-results/. Exit status 2 means the run
could not be performed or was inconclusive, for example because the prompt no
longer blocks Reddit and the simulation needs updating. Run
npm run test:live -- --help for details and options.
The code was written with the help of AI tools. It is checked by the automated and live tests described above.
MPL 2.0. Not affiliated with or endorsed by Reddit. Thanks to the uBlock Origin community, whose work on Reddit's prompts informed this independent implementation, which bundles no filter lists.