Skip to Content
🎉 New: AI Sign Language Avatars now in beta! Learn more →

HTML Embed Integration

The simplest way to add accessibility features to any website. Works on all browsers and requires no framework dependencies.

Basic Implementation

1. Copy the Embed Code

<script src="https://cdn-01.accessiblykit.com/ally-widget.bundle.js" data-widget-id="05e86a3f-2c94-4071-b971-e2947269ddfd"> </script>

2. Paste Before </body>

Place this code just before your closing </body> tag for optimal performance.

Pasting the embed code in HTML

Pasting the embed code in HTML (Click to play)

Configuration Options

Basic Configuration

<script src="https://cdn-01.accessiblykit.com/ally-widget.bundle.js" data-widget-id="05e86a3f-2c94-4071-b971-e2947269ddfd" data-theme="light|dark|auto" data-language="en"> </script>
ParameterValuesDefault
data-themelight, dark, autoauto
data-languageISO language codeen

Best Practices

  1. Placement Matters

    • Always load the script before </body>
    • Avoid async/defer attributes
  2. Performance Tips

<link rel="preconnect" href="https://cdn-01.accessiblykit.com"> <link rel="preload" as="script" href="https://cdn-01.accessiblykit.com/ally-widget.bundle.js">
  1. Troubleshooting
    • If widget doesn’t appear, check browser console for errors
    • Verify your widget ID is correct
    • Ensure no content security policies are blocking the script

JavaScript API Control

After embedding, you can control the widget programmatically:

// Open widget window.AccessibilityWidgetAPI?.openWidget(); // Enable specific profile window.AccessibilityWidgetAPI?.enableProfile('motor_impaired'); // Check if loaded if (typeof AccessibilityWidgetAPI !== 'undefined') { // API is available }

Remember to replace the example widget ID with your actual ID from the dashboard.