If the UserWay Accessibility Widget doesn't appear, its menu won't open, or a widget feature isn't working, your website's Content Security Policy (CSP) may be blocking a resource the widget needs.
A CSP controls which resources a website can load. If the browser reports an enforced CSP violation for a UserWay resource, allow https://*.userway.org in the directive named in the violation message, and keep the rest of your existing policy.
ℹ️ Note: Before you change your policy, confirm that the browser is reporting an enforced CSP violation. A missing or broken widget doesn't always mean there's a CSP problem.
Identify the Blocked Resource
Open the affected page, then open your browser's Developer Tools (F12 on Windows/Linux, or Cmd + Option + I on macOS).
Click the Console tab, then reload the page.
Try to open the widget or use the feature that isn't working.
Review any CSP violation messages. To narrow the results, filter for
userwayorcdn.userway.org.Note the blocked resource URL and the directive named in each message.
Review the Relevant Directive
CSP directives control different resource types:
Directive | Resource type |
| Scripts |
| Stylesheets |
| Images |
| Requests made through script interfaces |
| Fonts loaded through |
| Resources loaded through audio and video elements |
| Frames and iframes |
Apply and Verify Changes
⚠️ Important: Have your website administrator or security team review each blocked resource before allowing it. Add UserWay sources to your existing policy, and don't replace your policy with a generic example.
Add
https://*.userway.orgto the directive named in the violation message, in every enforced policy that blocks the resource.Deploy the updated policy.
Reload the page and confirm the updated policy is being delivered.
Open the widget and test the feature that wasn't working.
Check the Console for any remaining CSP violations.
Expected Result
The UserWay Accessibility Widget loads, its menu opens, and the affected feature works with no CSP violations in the browser Console.
Need more help?
Contact the UserWay Support Team — we're here to assist you.
Get in touch with UserWay Support.