Back To Top

Your Website Has Schema. But What Does It Actually Say?

Summary

  • Schema markup helps machines understand what content describes and how its entities relate.
  • Basic schema may identify a page without explaining the information that lives on it.
  • Connected healthcare schema links physicians, conditions, services, locations, and other relevant facts. This helps AI answer complex questions.
  • Marketing should define the priority patient questions, facts, and relationships. IT should determine how to build and publish that information.

Who’s handling schema markup for your healthcare org?

When we ask new clients about schema, we often hear, “Our CMS does it,” or “IT/our web team handles it.” But “handled” doesn’t necessarily mean optimized.

Simply having schema isn’t enough. Schema markup can be present but generic. We’ve found that many marketing teams are unwittingly stuck with default schema from their CMS or plugin that checks the box without providing much value.

If your Spidey senses are tingling and you’re getting the urge to burn it all down, remember: Everyone’s figuring this stuff out at the same time. It’s not too late to take a closer look.

Without further ado:

  • A brief crash course on schema markup for healthcare
  • The difference between basic and connected schema
  • 5 questions to ask IT about healthcare schema markup

Prefer to watch?

Our founder, Ahava Leibtag, and Tim Voyles at HealthStack Partners talked all things schema in a webinar recorded by Strategic Health Care Marketing.

WATCH: Demystifying the Power of Schema in Search

Healthcare schema 101: The basics for marketers

What is schema markup?

Schema markup is a standard language that tells AI and search engines what your content describes and how its entities relate. It uses a shared vocabulary from Schema.org and is often added to pages as JSON-LD, which is Google’s preferred format for structured data.

The information on your website exists in:

  • Visible copy: What users see on the front-end
  • CMS fields: How editors structure content on the backend
  • Schema: What makes the information machine-readable

Representation of how information might look in visible copy, within the CMS, and in machine-readable schema markup

Structured content organizes the information. Schema explains its meaning to machines.

What is an entity?

An entity is a person, place, service, condition, or organization with its own identity. It can appear in many places across your website — or the web at large — and carries the same meaning everywhere it’s mentioned. Key entities for a health system include physicians, locations, clinical programs, and the organization itself.

Entity diagram showing how one physician may show up across a provider page, scheduling record, credentialing system, and article byline

Schema turns assorted facts into connected meaning

Schema markup helps AI and agents understand key facts about your organization and how they relate.

Healthcare websites are often structured so that key facts are disconnected — living on separate pages or all within one text field that machines must parse to interpret meaning. This makes it hard for AI to answer multi-part prompts like “AFib specialist near Bethesda accepting new patients.”

This is where schema markup joins the chat. Schema connects the dots between facts, telling machines: Dr. Jane Smith is a cardiologist who treats AFib, works at Main Street Health, and practices at Bethesda Clinic on Monday-Friday.

Connected healthcare schema web linking a physician to their specialty, health system, location, and clinic’s open hours

Healthcare schema can also connect physicians to the insurance they accept and whether they’re currently seeing new patients. Connecting the right data helps AI answer patient questions, which can improve the appointment booking journey.

Types of schema markup for healthcare

Schema.org includes hundreds of schema types, but you only need the ones that accurately represent your website’s content.

Common schema types for healthcare organizations include:

  • MedicalOrganization: Identifies a health system or other medical organization
  • Hospital and MedicalClinic: Describe facilities, including their locations, specialties, hours, and available services
  • IndividualPhysician and Physician: Identify a single provider or a physician’s office
  • MedicalCondition: Identifies a disease, disorder, or other condition
  • MedicalProcedure, MedicalTherapy, and MedicalTest: Describe treatments, procedures, therapies, and diagnostic tests
  • MedicalWebPage: Identifies a webpage focused on a medical topic
  • Review and AggregateRating: Describe ratings and reviews displayed on provider or location pages
  • Article, FAQPage, and VideoObject: Identify common formats that healthcare orgs publish, although these types aren’t specific to healthcare

Hint: If your pages follow consistent templates (like condition, treatment, program, and locations pages), implement schema markup on those templates. This can help you scale the process of medical organization schema across your website.

Basic vs. connected schema: What’s the difference?

Basic schema is exactly what it sounds like: technically valid but limited in impact. For example, your CMS or plugin might automatically identify a page as a MedicalWebPage and provide its title and URL. While that may be accurate, it doesn’t tell machines much about the information.

Why basic schema doesn’t cut it:

 

 

Connected schema adds healthcare-specific entities and expresses the relationships among them. This is the “level” of schema that connects the dots between Dr. Jane Smith, AFib, and Bethesda Clinic for machines.

Basic schema

Connected schema

Identifies

General elements such as the webpage type and organization Physicians, conditions, services, locations, and other entities

Communicates

Isolated facts about the page Relationships among the entities

Tells machines

“This is a medical webpage called Heart Rhythm Center” “The Heart Rhythm Center at Bethesda Clinic treats AFib, and Dr. Jane Smith provides that care”

Supports

Basic machine understanding of the page AI answers that can support the patient journey

 

Connected schema alone doesn’t guarantee AI visibility, but it gives machines clearer information and reduces how much they need to infer about your org.

Marketing’s role in healthcare schema

Schema markup is a shared responsibility. Marketing defines the use case and meaning, while technical teams build the connections and publishing logic.

Marketing’s role:

Task

Examples

1. Start with business-critical patient questions “Who treats AFib at Bethesda Clinic and is accepting new patients?”
2. Define the facts needed to answer it Provider, condition, location, and availability
3. Identify the sources of information CMS, provider directory, and scheduling data
4. Map the relationships Treats, practices at, and accepts patients

 

5 questions to ask IT about schema markup

Simply confirming that schema exists is not enough. Bring these questions to IT to help you understand what your schema actually communicates, whether it reflects the business, and how it’s governed.

Ask for an inventory of the schema produced on representative page types. This will show whether your CMS is generating only generic markup or something more customized.

Confirm whether the schema identifies priority entities such as physicians, services, conditions, and locations, as well as the relationships among them. Having schema on a page does not mean it describes the information patients need.

Find out which system owns each fact. Schema can publish the information it receives, but it can’t resolve internal disagreements between your CMS, provider directory, and scheduling system.

Separate what your CMS already does from the development needed to add fields, connect records, or pull facts from another system. This helps clarify the technical requirements and associated investment.

Assign responsibility for testing the markup and updating it when the information changes. Without an owner, schema can become outdated or stop matching what patients see on the page.

Need outside help?

Not sure whether your schema is connected and actually supporting your AI visibility? We can help you run a content inventory, put together a game plan, implement the schema, and build the necessary governance around the operation. Let’s talk about it.