disambiguatingDescription
disambiguatingDescription · Optional
Appears in
What is it?
disambiguatingDescription is a short text that distinguishes an entity from other similar entities. It is a sub-property of description, specifically designed for disambiguation, the brief phrase that answers "which one is this?" when multiple entities share the same or similar name.
Think of it as the parenthetical qualifier in a Wikipedia page title: "(software company)" in "Apple (software company)" versus "(record label)".
Why this matters for AEO
Entity disambiguation is a core challenge for AI answer engines. When a user asks about "Mercury", is that the planet, the car brand, the Greek god, or the record label? disambiguatingDescription provides the anchor text AI systems use to differentiate between entities with the same or similar names.
For organizations sharing names with other businesses, geographic features, or common words, disambiguatingDescription reduces the risk of being conflated with an unrelated entity in knowledge graph results. It is particularly important for companies with generic or common names.
What the specs say
Schema.org:disambiguatingDescription expects Text. "A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation." [Source: https://schema.org/disambiguatingDescription]
Google: Not mentioned in Google's structured data documentation for Organization.
How to find your value
Write a 5-15 word phrase that identifies what type of entity this is and what it does:
- "Project management software company based in Chicago"
- "Independent bookstore in Portland, Oregon"
- "UK-registered pharmaceutical research organization"
- "Non-profit wildlife conservation fund"
The phrase should uniquely identify this entity relative to others with similar names. It is not a marketing tagline, it is a factual classification.
Format and code
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Mercury",
"disambiguatingDescription": "American automobile brand owned by Ford Motor Company",
"url": "https://ford.com"
}
Organization with common name:
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Signal",
"disambiguatingDescription": "Non-profit technology organization developing encrypted messaging software",
"url": "https://signal.org"
}
Invalid, using it as a marketing tagline:
{
"@type": "Organization",
"disambiguatingDescription": "The world's leading platform for team collaboration"
}
disambiguatingDescription should be a factual classification, not a promotional claim.
Webflow implementation
Static pages
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Your Company",
"disambiguatingDescription": "B2B SaaS company providing project management software"
}
</script>
CMS template pages
For a business directory, add a plain text CMS field "Short Description" or "Disambiguating Description":
"disambiguatingDescription": "{{wf {"path":"short-description"} }}"
In Schema HQ
disambiguatingDescription is emitted in the Organization schema configuration alongside description. It serves as the entity summary used for disambiguation.
Real examples
Signal Foundation :*
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Signal",
"disambiguatingDescription": "Non-profit technology organization developing the Signal encrypted messaging app",
"url": "https://signal.org"
}
Related fields
- description — longer textual description
- name — entity name that disambiguation contextualizes
- alternateName — other names for the entity
- keywords — topics associated with the entity
- additionalType — additional type classifications
FAQ
What is the difference between description and disambiguatingDescription?
description is a full-text summary of what the entity does, who it serves, and what makes it notable. disambiguatingDescription is a short identifier phrase that distinguishes this entity from similarly named ones. A description might be 3-5 sentences; a disambiguating description is typically one short clause.
Is this field used by Google?
Google does not explicitly document disambiguatingDescription for Organization structured data. It contributes to Knowledge Graph entity disambiguation. The value is most likely used by semantic search systems that process multiple entity records with overlapping names.
Can I use the same text for description and disambiguatingDescription?
No. disambiguatingDescription is a sub-property of description for a specific purpose, it should be shorter and more focused on differentiation. If you use the same text for both, it defeats the purpose of the field.