Prompt
My chat widget isn’t working on mobile. What should I check?
Latest observation
Nov 1, 2026
OpenAI APIWeb search: off
If a chat widget works on desktop but not mobile, the usual suspects are:
-
Responsive CSS issues
- The widget may be hidden on small screens via media queries.
- Check for
display: none,visibility: hidden,opacity: 0, orz-indexproblems on mobile breakpoints. - Make sure it isn’t off-screen because of
position: fixed/absolute+bottom/rightvalues.
-
Touch/viewport conflicts
- The widget may be covered by another mobile UI element.
- Confirm it responds to taps, not just hover-based interactions.
-
JavaScript errors on mobile
- Open remote debugging and check the console for errors.
- Some code may rely on mouse events (
mouseenter,mouseover) instead of touch/click events.
-
Script loading or initialization issues
- The embed script might be blocked, delayed, or failing on slower mobile networks.
- Verify the widget script loads and initializes on mobile pages.
-
Cookie/localStorage/session restrictions
- Mobile browsers can be more aggressive about storage/privacy restrictions.
- If your widget depends on cookies or third-party storage, it may fail in some browsers.
-
Third-party blocking / browser settings
- Safari on iPhone, in-app browsers, or ad blockers may block chat scripts.
- Test in Chrome, Safari, and an in-app browser.
-
Viewport/meta tag problems
- Missing or incorrect
<meta name="viewport">can break layout and placement. - Confirm the page isn’t being rendered in a desktop-scaled layout on mobile.
- Missing or incorrect
-
Network / CSP issues
- Check Content Security Policy, CORS, and mixed-content blocking.
- Ensure the widget domain is allowed and HTTPS is used everywhere.
-
Mobile-specific widget settings
- Some chat platforms have separate mobile behavior settings.
- Look for options like “hide on mobile,” “minimized on small screens,” or “launch button disabled on mobile.”
-
Iframe/embed constraints
- If the widget is inside an iframe, mobile browsers can be stricter about sizing, focus, and scroll behavior.
Quick debugging checklist
- Test on a real device, not just emulator.
- Inspect console/network logs on mobile.
- Temporarily disable custom CSS/JS to isolate the issue.
- Compare desktop vs mobile HTML/classes injected by the widget.
- Try another browser and an incognito/private session.
If you want, I can help you debug it step by step if you share:
- the widget provider,
- the page URL or a code snippet,
- and what “isn’t working” means exactly (not visible, not clickable, won’t open, etc.).