> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Web SDK Accessibility

<Badge icon="arrow-left" color="gray">[Back to Web SDK Overview](/ai-for-service/sdk/web-sdk)</Badge>

The Web SDK chat widget is designed to meet **WCAG 2.2 Level AA** (ADA AA) standards. This page covers compliance status, supported components, and developer guidelines for maintaining accessibility in customizations.

For a full overview of the SDK, see [How the Web SDK Works](/ai-for-service/sdk/how-web-sdk-works#how-the-web-sdk-works).

***

## Compliance Status

| Product      | Compliance Level                    |
| ------------ | ----------------------------------- |
| Kore Web SDK | Full compliance — WCAG 2.2 Level AA |

For details, see the official [WCAG 2.2 documentation](https://www.w3.org/TR/WCAG22/) or download the [Voluntary Product Accessibility Template (VPAT)](https://github.com/Koredotcom/docs-v2/raw/refs/heads/main/ai-for-service/sdk/images/koreai-accessibility-conformance-report.pdf).

***

## Accessibility Support by Component

| Component      | Accessible | Preview                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| -------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Chat Icon      | Yes        | <img src="https://mintcdn.com/koreai/FcokfuZEKoJtxBg1/ai-for-service/sdk/images/image1.png?fit=max&auto=format&n=FcokfuZEKoJtxBg1&q=85&s=a94f4c8017d2562d47b20d3439e9c45d" alt="Chat Icon" width="636" height="807" data-path="ai-for-service/sdk/images/image1.png" />      |
| Chat Window    | Yes        | <img src="https://mintcdn.com/koreai/FcokfuZEKoJtxBg1/ai-for-service/sdk/images/image2.png?fit=max&auto=format&n=FcokfuZEKoJtxBg1&q=85&s=a7d3757838584bbbd76cab8acb030a8c" alt="Chat Window" width="646" height="812" data-path="ai-for-service/sdk/images/image2.png" />    |
| Welcome Screen | Yes        | <img src="https://mintcdn.com/koreai/FcokfuZEKoJtxBg1/ai-for-service/sdk/images/image3.png?fit=max&auto=format&n=FcokfuZEKoJtxBg1&q=85&s=352a97a897436f3c414634af049bab30" alt="Welcome Screen" width="640" height="846" data-path="ai-for-service/sdk/images/image3.png" /> |
| Header         | Yes        | <img src="https://mintcdn.com/koreai/FcokfuZEKoJtxBg1/ai-for-service/sdk/images/image4.png?fit=max&auto=format&n=FcokfuZEKoJtxBg1&q=85&s=912664a6a93511d818d9e9359dbf05be" alt="Header" width="635" height="809" data-path="ai-for-service/sdk/images/image4.png" />         |
| Footer         | Yes        | <img src="https://mintcdn.com/koreai/FcokfuZEKoJtxBg1/ai-for-service/sdk/images/image5.png?fit=max&auto=format&n=FcokfuZEKoJtxBg1&q=85&s=563a2896c2720d07f110577bfaa021b6" alt="Footer" width="554" height="460" data-path="ai-for-service/sdk/images/image5.png" />         |
| Templates      | Yes        | <img src="https://mintcdn.com/koreai/FcokfuZEKoJtxBg1/ai-for-service/sdk/images/image6.png?fit=max&auto=format&n=FcokfuZEKoJtxBg1&q=85&s=861a98de2f24b63ac215b226be7f6f00" alt="Templates" width="627" height="808" data-path="ai-for-service/sdk/images/image6.png" />      |

The SDK is fully compatible with screen readers.

***

## Themes and Color Contrast

Default light and dark themes maintain a color contrast ratio of **4.5:1 or higher**, meeting WCAG 2.2 Level AA out of the box.

For custom themes, follow the [Virtual Assistant Theme & Design guidelines](/ai-for-service/channels/add-web-mobile-client#adding-the-web-mobile-client-channel). Ensure:

* All color combinations meet minimum contrast ratios (4.5:1 normal text, 3:1 large text and UI elements).
* Interactive elements are clearly distinguishable.
* Focus indicators meet contrast requirements.
* Custom themes are tested with assistive technologies before deployment.

***

## Developer Guidelines

When customizing or extending the SDK, follow these practices to maintain compliance:

| Practice                | Requirement                                                                                                                                 |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Semantic HTML**       | Use appropriate HTML5 elements to define structure and meaning                                                                              |
| **ARIA attributes**     | Add ARIA roles and attributes for dynamic content and custom controls. See [WAI-ARIA Authoring Practices](https://www.w3.org/WAI/ARIA/apg/) |
| **Keyboard navigation** | All interactive elements must be focusable and keyboard-operable in a logical order                                                         |
| **Color contrast**      | Normal text: 4.5:1 minimum; large text and graphics: 3:1 minimum                                                                            |
| **Text alternatives**   | Provide `alt` text for all non-text content (icons, images)                                                                                 |
| **Responsive design**   | Ensure the widget is accessible across screen sizes and orientations                                                                        |
| **Testing**             | Regularly test with tools and assistive technologies (NVDA, JAWS, VoiceOver)                                                                |

For customization reference, see the [Web SDK Customization Documentation](https://github.com/Koredotcom/web-kore-sdk/blob/v3/dev/docs/customizations).

Accessibility compliance for any customizations made beyond the default SDK is the responsibility of your organization.

***

## Support

If you encounter an accessibility issue or want to share feedback:

* **Email:** [support@kore.com](mailto:support@kore.com)
* **Support portal:** [https://support.kore.ai](https://support.kore.ai)

***
