W3C community group advances unified token schema to include accessibility metadata

Tech · 5 min read

The proposal extends existing token schemas by adding fields for intent, targetWCAG, and assistiveHints, enabling tokens to carry not just a value but a compliance story. For example, a color token can include target contrast ratios and recommended use cases (e.g., 'ui-text-large', 'icon-accent'), while a motion token can declare whether it's safe for reduced-motion modes.

Proponents say the schema will make automated audits and runtime adaptation easier: design tools can flag non-compliant token combinations; build systems can map tokens into platform-specific resources; and client apps can dynamically switch tokens based on user accessibility settings. The draft also includes examples for JSON-LD and YAML serializations to support toolchains.

The group is seeking implementer experiments—libraries, design tools, and platforms—to test the schema in the wild. If adopted, this could shrink the semantic gap between design artifacts and shipped products, making accessibility a visible and enforceable part of tokenized systems.