JSON-LD gives software a structured description of information on a page. Start with accurate visible facts, choose the appropriate vocabulary, and connect related entities consistently. Adding markup does not guarantee rich results, rankings, or a knowledge panel.
01
Inventory the facts first
List the organization name, official website, logo, public contact details, and relevant people or services. Decide which facts belong to the whole site and which describe one page. A founder biography should describe the founder; it should not turn every page into that person's profile. Do not add awards, offices, ratings, or credentials that the page cannot substantiate.
02
Connect descriptions without creating contradictions
Use a stable identifier for the same organization across related pages. A biography can refer to the person's actual employer, and an article can identify its real author. Keep the relationship understandable to a reader as well as a machine. More properties are not automatically better; missing optional information is preferable to invented detail or obsolete addresses.
- Match names and URLs to the current public website.
- Check that each entity describes the correct person or organization.
- Remove duplicate snippets that disagree about the same fact.
03
Validate the published result
For a simple example, compare a consultant's biography with its Person description: the name, role, official profile links, and photograph should refer to the same person. Validate syntax, review applicable Google feature requirements, and inspect what the published page actually delivers. A technically valid object can still be misleading or unsuitable for a search feature.
Frequently asked questions
Is JSON-LD visible to customers?
Usually it is embedded in page code. The important facts it describes should still be available in the ordinary page content where appropriate.
Should every possible schema type be added?
No. Choose types that accurately describe the content. Irrelevant or unsupported markup creates maintenance work and may misrepresent the page.
Continue with your next step
Related guides on this topic
Sources and policies
Check the current policy before submitting a request.
You do not have to figure out the next step alone.
Share the URLs and explain your concern. We will review the context and explain which options are worth assessing.
Request a confidential reviewOr call (307) 429-2531Educational information, not legal advice. Outcomes depend on the facts and decisions made by third parties.