This document provides use cases and a vocabulary of terms that can be used to enhance web content by providing information about form controls, symbols, and other user interface elements. User agents use the semantics to augment or adapt content to the user’s scenario. This helps users with varying needs to understand the content by providing support for simplification and a way to manage unnecessary distractions.

The Personalization Semantics Content Module 1.0 is an extension of the personalization semantics introduced in the Personalization Semantics Explainer 1.0 document [[personalization-semantics-1.0]].


This document provides personalization semantics and vocabularies that can be used to annotate web content enabling user agents to augment or adapt content to various user scenarios based on the user’s personalization settings or preferences.

Personalization semantics defines a set of properties and values to annotate content. The Personalization Task Force decide to use the data-* for attributes, Now the the first three attributes have been accepted by Task Force, there are data-purpose, data-action and data-destination. For other attributes, we are still on discussion. See our discussion Prototypes with data dash. If you have any comments or suggestions on implementation please add a comment to this issue list.

Use Cases and Requirements

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


Since implementation has not yet been finalized any examples in this document are purely for help in understanding the concept. All examples will be updated once a final decision has been made on the method for implementation.

Vocabulary Implementations

The vocabulary implementations included in this document are available at Personalization Explainer 1.0 Vocabulary Implementations section.

Acknowledgements placeholder