This specification provides web content authors a standard approach to support web users who are persons with various cognitive and learning disabilities, including users who:

The technology described in this specification is intended to be used to programmatically transform the appearance of typical web content including form controls, icons, and other user interface elements into a rendering more familiar and comprehensible to an individual user. Providing additional help is supported, as is automated page simplification. Use cases and relevant vocabulary terms are defined which allow user agents to augment or adapt content to better fit a particular user's particular needs. This helps users with varying needs to understand web content more readily, by simplifying the web interaction, and by avoiding forcing the user to grapple with unfamiliar representations they are ill equipped to comprehend.

This Personalization Semantics Content Module 1.0 is a component of the Personalization Semantics series introduced in the Personalization Semantics Explainer 1.0 document [[personalization-semantics-1.0]].



This specification module enables authors to add semantic information about content at the element level, in order to facilitate a more familiar or comprehensible interface for the individual user. Multiple screen renderings (transformations) are supported in order to meet the differing needs of different users. Final renderings — generated via helper apps or 3rd-party tools — are ultimately defined by the user's configuration settings.

The goal of the attributes and values described in this specification is to enable personalized communication and web content interaction for the individual user. This specification includes facilities to:

Personalization Semantics is a series of technical specifications that provide the element-level attributes and values which enable user agents and helper-applications to adapt content to an individual user's needs. It relies on author-supplied page and element level metadata in order to achieve individualized personalization.

Personalization Semantics currently consists of three modules: Content, Help and Support, and Personalization Tools. The specification defined in this document is the Personalization Semantics Content Module—the first of the Personalization Semantics Modules series.

Personalization Semantics is more fully introduced in our Personalization Semantics Explainer [[personalization-semantics-1.0]].

Personalization Semantics Content Module

Personalization Semantics Content Module is the first part of the Personalization Semantics technical specification, which provides personalization semantics and vocabularies that can be used to mark-up web content with additional semantic information, enabling user agents to augment or adapt content to various user-scenarios based on the user’s personalization settings or preferences. The Content Module enhances web content by providing additional information about form controls, buttons, links, and other user interface elements. User agents use these semantics to augment or adapt content to the user’s scenario — for example allowing for the conversion of text to symbols. This helps users with varying needs to understand the content by providing support for simplification and/or a way to manage unnecessary distractions.

Vocabulary Structure and Implementations

All the vocabulary in Personalization Semantics Content Module is constructed of properties and their values. Please see our Personalization Semantics Explainer.

The vocabulary implementations included in this document are available at our implementations wiki page.

Note that the attributes and values in this specification do not overide the semantics exposed in the accessibility tree, but rather augment them. In the case of conflict between an element's semantics and the attribute values, validation algorithms should issue a warning but not an error.

Since implementations have not yet been finalized, any examples in this document are illustrative only, and are provided to help in understanding the concept. All examples will be updated once implementation examples are finalized.

Use Cases and Requirements

The Requirements for Personalization Semantics describes use cases and requirements. This module provides properties to fulfill those requirements related to adapting content.


This document uses a number of specific terms related to various cognitive disabilities and related user-needs. Those terms have been defined by the Cognitive and Learning Disabilities Accessibility Task Force. See the COGA Glossary for specific definitions.


Privacy and Security Considerations

This specification adds context information about content to the document, and should not affect security.

Although this specification does not expose personal preferences and personal information, third party user agents or proxy server(s) acting upon our semantic information may need to store personal preferences on how to present content to a specific user. It is recommended that any user agent or proxy server implements best practices to protect all personal preferences and personal information.

Any user agent with user settings are recommended to follow best practices to keep user information secure.

The Privacy and Security Considerations of Personalization Semantics Content Module is also discussed at issue #131.

Acknowledgements placeholder