On this page:
This is some text inside of a div block.
This is some text inside of a div block.
This is some text inside of a div block.

alternateName

alternateName · Recommended

Appears in

Organization

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

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.

On this page:
This is some text inside of a div block.
This is some text inside of a div block.
This is some text inside of a div block.
Generate schema for your site with Schema HQ

Get Early Access

Get Early Access

Need help with schema on your site?

We implement structured data for Webflow sites — from audit to deployment.

Work with us

Work with us