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

# Xbox Accessibility Guidelines

> Overview of the XBOX Accessibility Guidelines (XAG v3.2) covering text, audio, input, UI, and photosensitivity best practices for games evaluated by MGATS.

The **XBOX Accessibility Guidelines (XAGs)** are best practices developed with industry experts and the Gaming and Disability Community. They serve as:

* **Idea generators** for designers.
* **Guardrails** for developers.
* **Validation checklists** for test teams.

The XAGs are **not** a compliance checklist. They exist to make games enjoyable and playable for everyone. Microsoft's accessibility testing service (MGATS) evaluates against the XAGs.

> [!NOTE]
>
> Current published version: **XAG v3.2** (Jun 8, 2023). For change history, contact your Microsoft representative.

## How each guideline is structured

Every XAG has the same sections:

* **Goal** — the desired impact on players.
* **Overview** — the barriers players with disabilities commonly encounter for this topic.
* **Scoping questions** — helps you decide whether the guideline applies to your title.
* **Background** — introductory material for complex topics.
* **Key areas to target** — game elements that must not be overlooked.
* **Implementation guidelines** — the prescriptive minimums.
* **Example content** — images and clips showing correct implementation.
* **Potential player impact** — the disability types most affected.
* **Resources and tools** — external reading.

## The 23 guidelines

### Visual

| # | Guideline | What it covers |
| - | - | - |
| **101** | [Text display](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-101-text-display.md) | Font size, line spacing, color, customization |
| **102** | [Contrast](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-102-contrast.md) | Foreground / background contrast ratios |
| **109** | [Object clarity](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-109-objective-clarity.md) | Distinguishability of in-game objects and objectives |
| **112** | [UI navigation](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-112-ui-navigation.md) | Logical reading and focus order |
| **113** | [UI focus handling](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-113-ui-focus-handling.md) | Visible focus indicators |
| **114** | [UI context](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-114-ui-context.md) | Headings, labels, and contextual cues |
| **117** | [Visual distractions and motion](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-117-visual-distractions-motion.md) | Camera shake, parallax, motion-blur opt-outs |
| **118** | [Photosensitivity](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-118-photosensitivity.md) | Flashing patterns, photosensitive-epilepsy safety |

### Audio

| # | Guideline | What it covers |
| - | - | - |
| **103** | [Additional cues](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-103-additional-cues.md) | Don't rely on a single sense for any cue |
| **104** | [Subtitles and captions](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-104-subtitles-captions.md) | Caption text, speaker labels, sound effects |
| **105** | [Audio accessibility](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-105-audio-accessibility.md) | Independent volume sliders for music / dialog / SFX / chat |
| **106** | [Screen narration](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-106-screen-narration.md) | TTS narration of UI for blind / low-vision players |
| **111** | [Audio description](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-111-audio-descriptions.md) | Narration of visual scenes / cinematics |

### Input

| # | Guideline | What it covers |
| - | - | - |
| **107** | [Input](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-107-input.md) | Remapping, hold-vs-tap, accessible peripherals |
| **110** | [Haptic feedback](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-110-haptic-feedback.md) | Optional and informative rumble |

### Difficulty and pace

| # | Guideline | What it covers |
| - | - | - |
| **108** | [Difficulty options](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-108-difficulty-options.md) | Difficulty selection, granular assists |
| **115** | [Error messages](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-115-error-messages.md) | Confirmations, undo, clear errors |
| **116** | [Time limits](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-116-time-limits.md) | Pause, extend, or disable time pressure |

### Communication

| # | Guideline | What it covers |
| - | - | - |
| **119** | [Chat (STT / TTS)](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-119-chat.md) | Built-in or platform-provided STT and TTS |
| **120** | [Communication experiences](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-120-communication-experiences.md) | Safer chat defaults, friction for unmoderated channels |

### Documentation and support

| # | Guideline | What it covers |
| - | - | - |
| **121** | [Accessible feature documentation](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-121-accessible-feature-documentation.md) | Where and how to document your accessibility features |
| **122** | [Accessible customer support](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-122-accessible-customer-support.md) | Multi-channel support for assistive-tech users |
| **123** | [Mental health best practices](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-123-mental-health-best-practices.md) | Safer content warnings, opt-outs, breaks |

## Use the XAGs in your process

**1. Design phase**

Run scoping questions against your design pillars. Mark in-scope guidelines and decide which assists to bake into core systems vs. options.

**2. Implementation phase**

Pull the implementation guidelines into your task tracker. Track per-feature accessibility acceptance criteria.

**3. QA / cert prep**

Run [MGATS](https://docs.xbox.com/build/game-principles/accessibility/mgats.md) before final cert. Address the report's findings before submitting.

**4. Store listing**

Document supported accessibility features in your [Properties](https://docs.xbox.com/publishing/game-publishing/concepts/properties-basic-info.md) module so they surface on the Store PDP.

## Related GDK building blocks

* [Accessibility overview](https://docs.xbox.com/build/game-principles/accessibility/accessibility-overview.md)
* [Speech accessibility user settings](https://docs.xbox.com/build/game-principles/accessibility/speech-accessibility.md)
* [Text-to-speech](https://docs.xbox.com/build/console-features/text-to-speech/text-to-speech.md)
* [XAccessibility API](https://docs.xbox.com/reference/system/xaccessibility/xaccessibility_members.md)
* [XSpeechSynthesizer API](https://docs.xbox.com/reference/system/xspeechsynthesizer/xspeechsynthesizer_members.md)

## See also

* [Gaming and Disability Player Experience Guide (GADPEG)](https://docs.xbox.com/build/game-principles/accessibility/gadpeg.md)
* [Gaming Accessibility Fundamentals learning path](https://docs.xbox.com/build/game-principles/accessibility/gaf-info.md)
* [MGATS](https://docs.xbox.com/build/game-principles/accessibility/mgats.md)
* [Accessibility feature tags](https://docs.xbox.com/build/game-principles/accessibility/accessibility-feature-tags.md)
* [XBOX Developer Programs](https://www.xbox.com/developers/id)

## Related API documentation

* [XGameUI API reference](https://docs.xbox.com/reference/system/xgameui/xgameui_members.md) — accessibility-aware system UI (speech-to-text, virtual keyboard)
* [XGameStreaming API reference](https://docs.xbox.com/reference/system/xgamestreaming/xgamestreaming_members.md) — physical stream dimensions for readable UI
* [Touch adaptation kit reference](https://docs.xbox.com/reference/system/touchadaptationkit/touchadaptationkit-reference.md) — touch layouts for accessibility


## Related topics

- [Xbox Accessibility Guideline 121](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-121-accessible-feature-documentation.md)
- [Xbox Accessibility Guideline 119](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-119-chat.md)
- [Xbox Accessibility Guideline 114](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-114-ui-context.md)
- [Xbox Accessibility Guideline 104](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-104-subtitles-captions.md)
- [Xbox Accessibility Guideline 105](https://docs.xbox.com/build/game-principles/accessibility/xag-deep-dives/xag-105-audio-accessibility.md)
