alternateName
alternateName · Recommended
Appears in
What is it?
alternateName is any other name by which an organization is commonly known, an acronym, a previous name, a nickname, or a brand name that differs from the registered name. It tells search engines and AI systems: "this entity is also known by these other names," which helps with entity disambiguation when users search using different name variants.
The field accepts a plain text string or an array of strings.
Why this matters for AEO
When a user asks about "3M" versus "Minnesota Mining and Manufacturing Company," or searches for "IBM" while the organization's registered name is "International Business Machines," alternateName bridges the gap. AI answer engines check alternate names when resolving entity references across different phrasings of the same query.
Google uses alternateName for entity canonicalization, consolidating references to the same organization under one knowledge graph node regardless of which name variant a user types. Without it, an organization with a well-known abbreviation or former name may have a fragmented knowledge graph presence.
What the specs say
Schema.org:alternateName expects Text. "An alias for the item." [Source: https://schema.org/alternateName]
Google: Recommended for Organization. "Another common name that your organization goes by, if applicable." [Source: https://developers.google.com/search/docs/appearance/structured-data/organization]
How to find your value
Consider these sources of alternate names:
- Acronym — "IBM" for "International Business Machines"
- Former name — Previous company name before rebranding
- Parent brand name — Trading name of a subsidiary known by parent brand
- Common abbreviation — "3M" for "Minnesota Mining and Manufacturing"
- Localized name — English name for a company with a non-English official name
Format and code
Single alternate name:
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "International Business Machines Corporation",
"alternateName": "IBM",
"url": "https://ibm.com"
}
Multiple alternate names (array):
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Minnesota Mining and Manufacturing Company",
"alternateName": ["3M", "MMM"],
"url": "https://3m.com"
}
Organization known by former name:
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Meta Platforms",
"alternateName": "Facebook",
"url": "https://meta.com"
}
Invalid, using alternateName for a description:
{
"@type": "Organization",
"alternateName": "The world's leading software company"
}
alternateName is for name variants, not descriptions. Use description or disambiguatingDescription for descriptive text.
Webflow implementation
Static pages
Add to Site Settings > Custom Code:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Your Full Company Name",
"alternateName": "YCN",
"url": "https://yoursite.com"
}
</script>
CMS template pages
For a directory with multiple organizations, add a plain text CMS field for alternate names:
"alternateName": "{{wf {"path":"alternate-name"} }}"
In Schema HQ
The alternateName field is set in the Organization schema configuration. Enter any alternate names alongside the primary name.
Real examples
No live crawl examples were found. Meta :
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Meta Platforms, Inc.",
"alternateName": ["Meta", "Facebook"],
"url": "https://meta.com"
}
Salesforce :
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Salesforce, Inc.",
"alternateName": "Salesforce",
"url": "https://salesforce.com"
}
Related fields
- name — the primary trading name
- legalName — the registered legal name
- disambiguatingDescription — short text that distinguishes this entity from similar ones
- sameAs — external URLs confirming identity
- description — longer description of the entity
FAQ
Should I include former company names in alternateName?
Yes, if users might search for your organization using the former name. This is especially important for companies that have rebranded within the last 5-10 years, where name recognition is still split between old and new names.
Is alternateName the right place for product names?
No. alternateName applies to the organization itself. If you want to link to products or brands, use brand for brand entities or owns for product organizations. alternateName should contain names that people use to refer to the organization.
Does Google display alternateName anywhere?
It does not appear directly in search snippets. It contributes to Knowledge Graph entity matching, which affects how search engines connect queries using different name forms to your entity's knowledge node.