Stop the Widget From Showing to All Visitors
Overview
Some site owners want the accessibility widget's floating button and panel to stop appearing for every visitor — while still keeping AllAccessible's automatic accessibility fixes running in the background. There is no single on/off switch for the widget in your dashboard. Instead, the control you're looking for is Headless Mode, found in the Advanced / Developer section of your Widget Settings. This guide explains what Headless Mode does, when to use it, a lighter option for mobile only, and what to do if you actually want to remove the widget entirely.
Who This Is For
Site owners who don't want the floating accessibility button visible to visitors
Developers who provide their own accessibility menu or entry point
Teams that want AllAccessible's automatic fixes to run "invisibly"
Anyone who only wants to hide the button on phones
What You'll Learn
Why there is no master on/off toggle for the widget
What Headless Mode does (and its important trade-off)
Where to find Headless Mode in Widget Settings
How to hide the button on mobile only
How to fully remove the widget if that's what you actually want
First: What Do You Actually Want to Stop?
There are three different outcomes people mean when they say "stop the widget from showing." Pick the one that matches your goal:
Your goal | The right control |
Hide the floating button and panel for all visitors, but keep automatic fixes running | Headless Mode |
Hide the floating button only on mobile devices | Hide on Mobile |
Remove AllAccessible from your site completely (no widget, no fixes) | Uninstall the widget snippet or plugin |
There is intentionally no "disable widget" master toggle in Widget Settings. If you simply turn the widget off, you'd also lose the automatic accessibility improvements — so the product separates "hide the interface" (Headless Mode) from "remove everything" (uninstall).
Option 1: Headless Mode (Hide the Widget for Everyone)
Headless Mode runs the accessibility scan and remediation pipeline without showing the floating widget button or panel to any visitor. Your site still benefits from AllAccessible's automatic, agentic AI adjustments — visitors just won't see the AllAccessible interface.
When to Use Headless Mode
You provide your own accessibility menu or trigger elsewhere on the page
You want fixes applied quietly in the background without a visible button
You're intentionally running the widget invisibly
Important Trade-Off
When Headless Mode is on, visitors cannot open the accessibility menu themselves on this subdomain. That means they can't personally adjust preferences like text size, contrast, or text-to-speech unless you give them another way to open the menu.
Enabling Headless Mode also hides every visible widget setting in the dashboard — the floating button, the accessibility menu, the move/hide controls, and the live preview — because there's nothing visible left to customize. The scan and auto-fix pipeline keeps running.
Only enable Headless Mode if you provide your own accessibility UI, or you are intentionally running the widget invisibly.
Where to Find It
Log in to app.allaccessible.org
Open your site, then your subdomain, and go to the Widget Settings tab
Scroll to the Advanced / Developer section (labeled "Lower-level options for developers. Most sites do not need to change these.")
Turn on Headless Mode
Click Save Changes
📷 Headless Mode toggle in the Advanced / Developer section of Widget Settings
Changes typically apply to your site immediately after saving. If you don't see the change right away, allow up to 30 minutes for cached widgets to propagate.
To Turn the Widget Back On
Return to Widget Settings → Advanced / Developer, switch Headless Mode off, and click Save Changes. Your appearance and behavior settings become editable again and the floating button returns.
Option 2: Hide on Mobile (Phones Only)
If your only concern is the button appearing on phones, you don't need Headless Mode. Use the Hide on Mobile control instead.
Open Widget Settings for your subdomain
Find the Trigger visibility section
Turn on Hide on mobile
Click Save Changes
This hides the trigger button on mobile breakpoints only. The widget still loads, and the accessibility menu can still be opened through any other entry point you provide. On desktop, the button appears normally.
Option 3: Remove the Widget Completely
If you want AllAccessible fully removed — no widget and no automatic fixes — you need to uninstall, not hide. Hiding controls keep the fix pipeline running; only uninstalling stops everything.
Custom/JavaScript installs: Remove the AllAccessible
<script>snippet from your site's HTML (or from your platform's custom-code / footer settings) and republish.WordPress: Deactivate and delete the AllAccessible plugin.
Drupal: Disable and uninstall the AllAccessible module.
Shopify: Remove the AllAccessible app from your store.
After uninstalling, clear any site or CDN cache and reload your site to confirm the widget is gone.
Troubleshooting
The button still appears after enabling Headless Mode
Confirm you clicked Save Changes after toggling Headless Mode
Wait up to 30 minutes for cached widgets to refresh
Hard-refresh your browser (Cmd+Shift+R / Ctrl+Shift+R) or test in a private window
Clear any caching plugin or CDN cache
Visitors say they can no longer open the accessibility menu
This is expected with Headless Mode on — the visible menu is hidden for everyone. If you want visitors to keep the menu, turn Headless Mode off and instead use appearance settings (position, size, colors) to make the button less prominent, or use Hide on Mobile if phones were the concern.
I only wanted to hide it on phones, but it's hidden everywhere
You likely enabled Headless Mode. Turn it off in Advanced / Developer, then enable Hide on mobile under Trigger visibility instead.
Frequently Asked Questions
Q: Is there a simple "disable widget" switch?
A: No. Widget Settings has no master on/off toggle. Use Headless Mode to hide the interface for all visitors, or uninstall to remove AllAccessible entirely.
Q: Do automatic accessibility fixes stop when I enable Headless Mode?
A: No. The scan and automatic remediation pipeline keeps running. Headless Mode only hides the visible button and panel.
Q: Can I hide the widget on some pages but not others?
A: Headless Mode and Hide on Mobile apply at the subdomain level, not per-page. For page-level control you would provide your own entry point and run in Headless Mode.
Q: Will Headless Mode affect my accessibility coverage?
A: The automatic fixes still apply. However, visitors lose the personal controls (text size, contrast, text-to-speech, etc.) unless you provide your own way to open the menu.
Related Articles
Widget Customization Overview - All widget settings explained
Changing Widget Position - Move the button to a less prominent corner
Customizing Widget Colors - Make the button blend with your design
Universal JavaScript Installation - Where the widget snippet lives (for uninstalling)
Last Updated: July 2026
Applies To: Widget Settings (Advanced / Developer)
