Products SEO & GEO Agent Paid Ads Agent Website Agent Conversion Agent
How it works Pricing FAQ Blog Book a call

Knowledge panel schema markup: feed Google the right facts

Updated · 8 min read

Want help applying this to your business? Talk it through on a free 30-minute call.

Book a call

Does schema markup get you a knowledge panel?

No. Google builds knowledge panels automatically from information across the web (Google Search Help: About knowledge panels), and says its "current policy doesn’t manually create or delete Knowledge Panels" (Google Search Help: Submit feedback on content about you). Your own site is one input you control. Organization markup is code on your site that labels your business facts, and Google explains what it does:

"Adding organization structured data to your home page can help Google better understand your organization's administrative details and disambiguate your organization in search results." (Google Search Central: Organization structured data)

Disambiguate means telling you apart from other businesses with a similar name. The same page says some properties work behind the scenes, while others can influence "which logo is shown in Search results and your knowledge panel".

Organization markup canIt can't
State your official name, other names, website and contact detailsCreate a panel or make Google show one
Point Google to the profiles that are really yours (sameAs)Change a Google Business Profile; you edit that in the profile
Tell Google which logo you wantRewrite the panel's description, which Google says "can’t be edited" (Google Search Help: Submit feedback)
Separate you from look-alike names with details such as your industry codeGuarantee a result: markup "does not guarantee that it will be present" (Google Search Central: General structured data guidelines)

A box with hours, reviews and directions is most likely a Business Profile, not a knowledge panel: see Google knowledge panel for your business to tell them apart and to claim either one. The markup is worth adding either way.

Which Organization schema properties does Google use?

Google requires none. It suggests where to start:

"We recommend focusing on properties that are useful to your users, such as name or alternateName for your business name as well as an indication of real-world presence (for example, address or telephone) and online presence (for example, url or logo)." (Google Search Central: Organization structured data)
PropertyWhat to enterGoogle's note
nameThe name on your sign and websiteUse the same name as your site name
alternateNameAn acronym or short name customers use"Another common name that your organization goes by"
urlYour home page"This helps Google uniquely identify your organization"
logoThe web address of your logo fileRules below
sameAsYour official profiles on other sitesNext section
descriptionOne plain sentence: what you do, and where"A detailed description of your organization"
telephone, emailMain customer phone and emailInclude the country code and area code
addressStreet, city, state or province, postal code, two-letter country code (US or CA)Leave it out if you hide your address (Google: "if applicable")
legalNameYour registered name, if it differs from nameFor example an LLC or a numbered company
naicsYour industry codeUsed behind the scenes to tell organizations apart
foundingDate, numberOfEmployees, taxID, vatID, duns, iso6523CodeOptional details, if they applyAnything in markup is public in your page code

The industry code is where the US and Canada differ. Both countries, with Mexico, use NAICS (the North American Industry Classification System), but "The sixth digit is used to designate national industries" (Statistics Canada: NAICS Canada 2022 introduction). Use the NAICS United States code for a US business and the NAICS Canada code for a Canadian one.

Other terms you may see suggested, such as founder, award, knowsAbout and areaServed, are real schema.org properties (Schema.org: Organization) but aren't on Google's Organization list. Google says other schema.org data "may be used to enable future Search features" (Google Search Central: Introduction to structured data); it doesn't say they affect knowledge panels.

sameAs schema: which profiles to list

sameAs is the list of your profiles on other websites. Google's definition:

"The URL of a page on another website with additional information about your organization, if applicable. For example, a URL to your organization's profile page on a social media or review site." (Google Search Central: Organization structured data)
ListLeave out
Your Facebook page, Instagram, LinkedIn company page, YouTube channel and X accountStaff members' personal profiles
Your profile on a review or industry site, such as Yelp, the BBB or a trade association directoryPages on your own website: sameAs points to another site
A Wikipedia or Wikidata page, only if one already exists about youAccounts you no longer run, or that belong to a business with a similar name
An online marketplace shop, such as your Etsy storeDirectory search pages that list many businesses

Three checks before you publish:

  1. Each profile is yours. Google's rules: "Don't impersonate any person or organization, or misrepresent your ownership, affiliation, or primary purpose." (Google Search Central: General structured data guidelines)
  2. Same name, visible links. Use your markup's business name on every profile, link each back to your site, and show the same profiles as footer icons. Google's general rule: "Don't mark up content that is not visible to readers of the page."
  3. Company logins. When you claim a panel, Google asks you to sign in to one of the official profiles it lists, such as YouTube, Google's free tool that shows which searches bring people to your site and flags pages Google can't index. More, Twitter or Facebook (Google Search Help: Get verified on Google). Keep those accounts under a company login, not a former employee's.

You don't need a Wikipedia page: Google's sameAs examples are social media and review profiles. Don't write one about your own business either. Wikipedia's conflict of interest (COI) guideline says: "COI editing is strongly discouraged on Wikipedia." (Wikipedia: Conflict of interest)

Knowledge panel logo: Google's image rules

Google says the logo property "can help Google better understand which logo you want to show, for example in Search results and knowledge panels" (Google Search Central: Organization structured data). Its rules for the file:

If your panel already shows the wrong image, a verified owner can suggest a new image URL. If it shows no image, Google says it can't add one by request (Google Search Help: Submit feedback on content about you).

How to add Organization schema to your website

One block, on one page. Google recommends "your home page, or a single page that describes your organization, for example the about us page", and says you don't need it on every page (Google Search Central: Organization structured data).

Use the most specific type: Google recommends a LocalBusiness subtype, such as Plumber or Dentist, for a local business, and OnlineStore for an online shop. LocalBusiness is "a subtype of Organization", so it carries every property above (Google Search Central: Local business structured data). The usual format is JSON-LD, code that sits in the page without showing to visitors. Google recommends it, but says "all 3 formats are equally fine for Google" (Google Search Central: Introduction to structured data).

  1. Fill in the values without code if you can. On WordPress with Yoast SEO, open Yoast SEO, then Settings, then Site representation. Choose Organization, enter the name, alternate name and logo, and add links to your social profiles (Yoast: Site representation settings). Google notes that Wix, WordPress and Shopify sites may have a search settings page or a plugin for this.
  2. Test it. Paste your page address into Google's Rich Results Test and fix any critical errors. If it finds two Organization blocks with different names, remove one.
  3. Ask Google to recrawl. Search Console's URL Inspection tool shows how Google sees the page and lets you request a recrawl. Google says "it may take several days after publishing a page for Google to find and crawl it."

Older guides send you to Google's Structured Data Testing Tool. It's gone: it became schema.org's Code on a page that states facts like your business name, hours and prices in a format search engines read reliably. More Validator, which checks syntax but not Google's features, and since August 2021 Google redirects the old tool (Google Search Central Blog: An update on the Structured Data Testing Tool).

Example

Illustrative cases.

A heating company with a white logo

White lettering on a transparent background nearly disappears on white. The owner saves a 400 by 400 pixel version on the company's dark blue and points the logo property to it, with HVACBusiness as the type.

A Toronto bookkeeping firm with a common name

A US company shares its name. The Toronto firm adds its numbered company as legalName, its address with country code CA, its NAICS Canada code, and sameAs links to its own LinkedIn and Facebook pages only.

An online candle shop

OnlineStore type, name, logo, and sameAs links to its Instagram and Etsy store. Google says merchants can also shape their merchant knowledge panel with details "such as return policy, address, and contact information", so it adds its 30-day return policy to the same block.

FAQ

How long until my knowledge panel changes?

No set time. Crawling a changed page can take several days (Google Search Central: Organization structured data), and Google reviews verified feedback "within a few days", sometimes longer (Google Search Help: Submit feedback).

Will schema fix a wrong fact in my panel?

Only if your site is the source: Google says changing the source usually changes the panel. Otherwise, fix that source or suggest an edit (Google Search Help: Submit feedback).

Does Organization schema help ChatGPT and AI answers?

Not required for Google's AI features: "there's no special schema.org markup you need to add" (Google Search Central: Optimizing for generative AI features). For other AI tools, see local business schema markup.

Different for you?

Keep learning

NextGoogle knowledge panel for your business: how to get and edit itKnowledge panel or Business Profile? How Google builds the box beside your name, how to claim it, how to suggest edits, and what a local business needs.

Ask us one question

One line is enough. We reply by email.

Sources

  1. Google Search Central: Organization structured data
  2. Google Search Central: Introduction to structured data markup
  3. Google Search Central: General structured data guidelines
  4. Google Search Central: Local business (LocalBusiness) structured data
  5. Google Search Central: Image SEO best practices
  6. Google Search Central: Optimizing for generative AI features on Google Search
  7. Google Search Central Blog: An update on the Structured Data Testing Tool (December 2020, updated August 2021)
  8. Google Search Help: About knowledge panels
  9. Google Search Help: Get verified on Google
  10. Google Search Help: Submit feedback on content about you
  11. Statistics Canada: NAICS Canada 2022 Version 1.0, introduction
  12. Schema.org: Organization
  13. Wikipedia: Conflict of interest guideline
  14. Yoast: Yoast SEO settings, Site representation