EPUB Accessibility 1.1, a W3C Recommendation that goes with EPUB 3.3, says that every EPUB publication
must describe its accessibility in the package document,
whether or not the book is accessible. The description uses properties from schema.org, whose terms are
fixed by the Schema.org Accessibility Properties for Discoverability Vocabulary (a W3C Community Group
report, 18 July 2023). Each property is a meta element with the prefix
schema:, which EPUB reserves, and may be repeated. The explorer checks every value against the
lists below.
What a publication must say
| Property | Requirement | What it says |
|---|---|---|
schema:accessMode | MUST | The senses or faculties needed to take in the content: textual, visual, auditory, tactile. |
schema:accessibilityFeature | MUST | Features and adaptations that help: alternative text, captions, a table of contents. |
schema:accessibilityHazard | MUST | Hazards the content presents: flashing, motion simulation, sound. |
schema:accessibilitySummary | SHOULD | A human-readable summary that adds to, and does not repeat, the other metadata, including any known deficiencies. |
schema:accessModeSufficient | SHOULD | A set of access modes enough to read the whole book without losing information, so unlike accessMode it counts alternatives such as transcripts. It may be repeated, one set a time, and a set is a comma-separated list. |
Other schema.org accessibility properties may be added. Metadata that sits only in a linked record
(a link element) does not satisfy the requirement.
The conformance statement
A publication that claims conformance has a dcterms:conformsTo property whose value, after
white space is collapsed, matches this pattern exactly, in case and spacing:
EPUB Accessibility A11Y-VER - WCAG WCAG-VER Level WCAG-LVL
A11Y-VER is 1.1 or higher, WCAG-VER is 2.0 or higher and
WCAG-LVL is A, AA or AAA. The specification lists nine
valid strings: EPUB Accessibility 1.1 - WCAG 2.0 Level A, AA and AAA,
and the same for WCAG 2.1 and 2.2. A publication may have several conformsTo statements, a
WCAG conformance URL for a claim that is only about WCAG, or the value none to say that it
meets no accessibility standard (for example to claim an exemption).
accessMode and accessModeSufficient
accessMode takes these eleven terms: auditory, chartOnVisual,
chemOnVisual, colorDependent, diagramOnVisual,
mathOnVisual, musicOnVisual, tactile, textOnVisual,
textual and visual. accessModeSufficient takes only
auditory, tactile, textual and visual, alone or as a
comma-separated list such as textual,visual.
accessibilityFeature
| Group | Terms |
|---|---|
| Structure and navigation | annotations, ARIA, bookmarks (deprecated), index, pageBreakMarkers, pageNavigation, readingOrder, structuralNavigation, tableOfContents, taggedPDF |
| Adaptations | alternativeText, audioDescription, captions (deprecated), closedCaptions, describedMath, longDescription, openCaptions, signLanguage, transcript |
| Rendering control | displayTransformability, synchronizedAudioText, timingControl, unlocked |
| Specialised markup | ChemML, latex, MathML, ttsMarkup |
| Clarity | highContrastAudio, highContrastDisplay, largePrint |
| Tactile | braille, tactileGraphic, tactileObject |
| Internationalisation | fullRubyAnnotations, horizontalWriting, rubyAnnotations, verticalWriting, withAdditionalWordSegmentation, withoutAdditionalWordSegmentation |
| No feature, or not known | none, unknown |
accessibilityHazard
| Kind | Terms |
|---|---|
| The hazard is there | flashing, motionSimulation, sound |
| No hazard | none, noFlashingHazard, noMotionSimulationHazard, noSoundHazard |
| Not known | unknown, unknownFlashingHazard, unknownMotionSimulationHazard, unknownSoundHazard |
accessibilityControl and accessibilityAPI
These two are not required by EPUB Accessibility 1.1 but belong to the same vocabulary.
accessibilityControl: fullKeyboardControl, fullMouseControl,
fullSwitchControl, fullTouchControl, fullVideoControl,
fullVoiceControl. accessibilityAPI: AndroidAccessibility,
ARIA (deprecated), ATK, AT-SPI, BlackberryAccessibility
(obsolete), FuchsiaAccessibility, IAccessible2, iOSAccessibility
(deprecated), JavaAccessibility, MacOSXAccessibility (deprecated),
MSAA, NSAccessibility, UIAccessibility, UIAutomation.
The a11y: certifier properties
EPUB itself defines three properties in the a11y: vocabulary (reserved prefix, URL
http://www.idpf.org/epub/vocab/package/a11y/#), for a third party that tested the book.
| Property | Value | Times | Meaning |
|---|---|---|---|
a11y:certifiedBy | text | one or more | The party responsible for testing and certifying the accessibility. |
a11y:certifierCredential | text | zero or more | A credential or badge that gives that party its authority. It refines the certifiedBy it belongs to. |
a11y:certifierReport | a link to a report | zero or more | An accessibility report by that party. |
Privacy
Writing the metadata raises no privacy or security question. Using it can: a reading system or shop that builds a profile of what a reader needs should not do so without explicit permission, and must give a way to remove the profile.
What the explorer checks
The EPUB viewer lists every schema:, a11y: and dcterms:conformsTo
property under Accessibility metadata on its Metadata tab. It reports a term that is not in the
vocabulary, a deprecated term, an unknown a11y: property and a
conformsTo value that does not match the pattern above.