
The hidden SEO advantage with accessibility properties in JSON-LD
Learn how JSON-LD accessibility properties boost SEO, improve E-E-A-T, and prepare your site for the future of inclusive search.
While developers obsess over Core Web Vitals and keyword density, a powerful SEO signal hides in plain sight: accessibility metadata. By adding schema.org’s accessibility properties to your JSON-LD, you’re not just helping users with disabilities – you’re creating machine-readable proof of quality that search engines are already beginning to prioritize.
Introduction
JSON-LD (JavaScript Object Notation for Linked Data) is a lightweight data interchange format that is easy to read and write. It is also used for structuring and linking data on the web, making it a crucial tool for search engine optimization (SEO). One of the hidden SEO advantages of using JSON-LD is its ability to provide accessibility properties.
What are accessibility properties in JSON-LD?
Accessibility properties in JSON-LD refer to the metadata that describes the characteristics of a webpage or a piece of content, making it more understandable and navigable for search engines and assistive technologies.
Adding accessibility properties to the schema is a fantastic way to signal to search engines that your content is optimized for screen readers and diverse users.
Here is an example JSON-LD:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebPage",
"name": "Your page title",
"description": "A brief description of your content.",
"accessibilityFeature": [
"alternativeText",
"readingOrder",
"tableOfContents"
],
"accessMode": [
"textual",
"visual"
],
"accessModeSufficient": [
{
"@type": "ItemList",
"itemListElement": [
"textual"
]
}
],
"accessibilityControl": [
"fullKeyboardControl",
"fullMouseControl"
],
"accessibilityHazard": "noFlashingHazard",
"accessibilitySummary": "This page is fully navigable via keyboard and includes alternative text for all informative images, making it accessible to screen reader users.",
"speakable": {
"@type": "SpeakableSpecification",
"cssSelector": [
"h1.entry-title",
"p.post-about"
]
}
}
</script>Core JSON-LD accessibility properties
| Property | Value example | Meaning for search engines |
|---|---|---|
accessibilityFeature | alternativeText | Signals a well-structured document and provides data that may eventually power accessible-onlysearch filters or badges. |
accessMode | textual, visual | Allows engines to categorize content by sensory type, aiding in matching specific user preferences in future personalized search. |
accessModeSufficient | textual | Crucial for discovery. Signals that the content is fully consumable in text-only formats (ideal for screen readers or low-bandwidth). |
accessibilityControl | fullKeyboardControl | Identifies technical compliance. Serves as a high-quality signal for inclusive design which may influence future ranking algorithms. |
accessibilityHazard | noFlashingHazard | Provides safety data that search engines could use to warn or protect photosensitive users before they click a link. |
accessibilitySummary | Custom string | Offers a descriptive snippet that could potentially be displayed in SERPs to help users evaluate page usability at a glance. |
Example value for accessibilitySummary:
SiteLint is committed to digital inclusion. This page adheres to WCAG 2.2 Level AA standards, featuring logical reading order, full keyboard operability, and high-contrast visuals to ensure a seamless experience for users of assistive technologies.
The speakable property
You probably notice the speakable property defined in JSON-LD schema.
The JSON-LD speakable property is a powerful schema addition that identifies specific sections of your content (like a headline and a summary) that are especially suited for audio playback via Google Assistant, Alexa, or Siri.
For an accessibility-focused site, this is the logical next step: it transitions your site from being readable by screen readers
to being voice-search ready
.
How speakable works
The speakable property uses CSS selectors (IDs or class names) or XPaths to tell the voice assistant exactly what to read aloud. This prevents the assistant from reading out junk
content like navigation menus, dates, or image captions.
Implementation speakable in your WebPage schema node
You should add this property to your WebPage object:
speakable property"@type": "WebPage",
"@id": 'current page URL',
// ... your existing properties ...
"speakable": {
"@type": "SpeakableSpecification",
"cssSelector": [
"h1.entry-title",
".entry-excerpt",
".speakable-summary" // If you display your summary on the page
]
},Choosing the right selectors
- Headline: usually
h1.entry-titleor.post-titlewhen using WordPress, for example. Generally, it is safer to use a CSS class oridattribute, instead of pointing to an element, e.g.h1only. If a page has multipleh1element, some voice assistants might get confused or only read the first one. - Summary: if you have a lead paragraph or an excerpt displayed at the top of the post, give it a specific class like
speakable-summary. - Constraint: Google recommends keeping the total speakable content to around 2-3 sentences (roughly 20-30 seconds of audio).
Technical requirements for speakable
Google has specific eligibility
rules for this property:
- Don’t over-select: do not mark the entire article body as speakable. Voice assistants are meant for summaries, not audiobooks.
- Text quality: the text within the selectors should be concise.
Visual diagram that illustrates how accessibility JSON-LD properties act as a bridge between accessible code and search engine understanding

The diagram shows a four-stage flow: 1) Your accessible HTML/CSS code provides the foundation, 2) JSON-LD properties translate these human-readable features into structured machine-readable metadata (accessibilityFeature, accessibilityControl, etc.), 3) Search engine crawlers parse this bridge data to algorithmically understand your accessibility level, and 4) This enhanced understanding influences SERP features, E-E-A-T signals, and rankings – ultimately creating a more inclusive user experience for all visitors, including those using assistive technologies.
You can play with this diagram on Mermaid Live Editor.
What are the benefits of including accessibility-related data in a schema?
Having accessibility data in your Schema markup serves as a digital bridge
between your technical efforts and how search engines perceive your site’s quality. While not a direct ranking factor
in the same way backlinks are, it provides significant indirect benefits.
Semantic clarity for search engines
Search engines like Google are moving toward Search Intent and User Experience. By declaring properties like accessibilityFeature or accessibilityControl, you are explicitly telling the crawler: This page is not just relevant to the topic, but it is also usable for people with disabilities.
.
Preparation for Accessible Search
There is a growing trend toward specialized search tools and filters. Just as users can filter for Open now
in Google Maps, it is anticipated that search engines may eventually offer filters for Accessible Content
(e.g., content with alternativeText or fullKeyboardControl).
Having this data ready puts you ahead of the curve.
Potential for enhanced visibility
While search engines primarily use accessibility metadata for indexing and discovery today, providing this detailed information future-proofs your content.
As search algorithms evolve, this metadata could lead to specialized rich snippets or higher visibility in filtered searches for accessible content, potentially increasing click-through rates from users with specific needs.
Strengthening E-E-A-T through technical integrity
For entities positioning themselves as authorities in web standards, including accessibility schema serves as a signal of technical thoroughness.
While metadata alone is not a substitute for a truly accessible infrastructure, its presence demonstrates an alignment between a creator’s stated expertise and their technical documentation. In the context of E-E-A-T, this consistency helps search engines categorize a brand as an active participant in specialized niches, even if the schema itself is only one small part of a much broader accessibility audit.
Synergy with WCAG compliance
Adding accessibility schema often acts as a final audit
for your development process. If you can’t honestly add alternativeText to your schema because your images lack alt tags, it highlights exactly where your site needs improvement.
A warning on vanity metrics
Testing your markup
You can test your schema using the Google Rich Results Test or Schema Markup Validator to ensure search engines can parse it correctly.
Conclusion
Accessibility properties in JSON-LD represent more than compliance – they’re a forward-looking SEO strategy. While competitors chase algorithmic ghosts, you’re building a site that serves all users and communicates that value directly to search engines.
The implementation is straightforward, the risk is minimal, and the potential upside includes better user experience, enhanced E-E-A-T signals, and positioning for the inevitable rise of accessibility-aware search.
Start today: audit one page, add accurate accessibility properties, validate your markup, and measure the impact.
The hidden advantage is only hidden until you use it.
Need help with digital accessibility?
- Audit and debug pages with reports in a user-friendly format directly from the browser.
- Install when you can't use browser extension.
- Audit fully rendered pages, including themes and plugins.
- Effortlessly audit every page automatically. Integrate a code snippet and manage multiple sites from a central dashboard.