This post is for SEO leads and developers who maintain treatment pages for clinics and hospitals, such as knee replacement, cataract surgery, endoscopy or IVF cycles, and who have been told to "add MedicalProcedure schema". It assumes you have already read a general guide to healthcare markup and want to know what each property is for, what to leave out, and what the markup can honestly be expected to do.
It answers three questions. Which MedicalProcedure properties map to content that a treatment page really contains? Which of them does Google act on, and which are only vocabulary? And how do you build the markup so it stays truthful after the clinical team edits the page?
The earlier articles on this site, including the complete implementation guide, the implementation guide and the advanced markup piece, cover syntax and the wider set of types. This article goes property by property on one type.
What Google reads and what it ignores
Start with the unglamorous fact. Google's structured data gallery lists the features that can change how a result looks, and none of them is a medical procedure feature. There is no rich result you earn by marking up a procedure.
That does not make the markup worthless, but it changes what you promise. Google's general structured data guidelines say it does not guarantee that markup will appear as a feature, and its 2023 note on FAQ and HowTo changes said that unused structured data causes no problem for Search but has no visible effect. For a type with no feature, that is the realistic expectation: no visible effect in Google's result pages.
What remains is a modest, defensible benefit. The markup is a machine-readable restatement of what the page already says. It may help a crawler, a parser or an AI tool identify that the page is about a named procedure, performed on a body part, with a preparation and a follow-up. We cannot show that any specific system uses these fields, and nothing in Google's documentation says it does. If someone promises a ranking lift from MedicalProcedure, ask for the evidence.
The rule that does apply is the visibility rule: do not mark up content that readers cannot see on the page. Every value you emit should be traceable to words on that URL.
The type tree matters more than you think
MedicalProcedure sits under MedicalEntity. Its direct subtypes are DiagnosticProcedure, PalliativeProcedure, PhysicalExam, SurgicalProcedure and TherapeuticProcedure. MedicalTherapy is a subtype of TherapeuticProcedure.
Choose the most specific subtype that is true.
- A biopsy or an endoscopy to examine something is a
DiagnosticProcedure. - An operation such as a joint replacement is a
SurgicalProcedure. - A course of treatment such as radiotherapy or physiotherapy fits
MedicalTherapyand its subtypes, for example RadiationTherapy and PhysicalTherapy. - When nothing more specific is accurate, use plain
MedicalProcedure.
The classification is a clinical judgement as much as a markup one. Ask the department to confirm it, and record the answer in the content register so it does not change by accident.
Property by property
The properties below are those the schema.org page defines specifically for MedicalProcedure. Each row says what to put in, where it comes from on the page, and the main trap.
| Property | Expected value | Source on the page | Trap |
|---|---|---|---|
name | Text | The procedure heading | Marketing names; use the name patients and clinicians recognise |
alternateName | Text | Common synonyms | Stuffing keywords |
procedureType | An enumerated member | The page's own classification | See below |
bodyLocation | Text | The area treated | Free text, so keep it plain and consistent |
preparation | Text or a MedicalEntity | The "before the procedure" section | Inventing instructions the page does not give |
howPerformed | Text | The "what happens" section | Copying a whole page into one field |
followup | Text | The "after the procedure" section | Recovery times that read as promises |
status | Event or study status, or Text | Rarely used | The definition refers to a study, so leave it empty |
procedureType
The value is a member of the MedicalProcedureType enumeration, which contains NoninvasiveProcedure and PercutaneousProcedure. SurgicalProcedure is not a member; it is a type. A common mistake is to write "procedureType": "SurgicalProcedure". If you want to say that a procedure is surgical, give the node the type SurgicalProcedure. If you want to say it is noninvasive or percutaneous, use the enumeration. Where neither fits cleanly, leave the property out rather than forcing a value.
bodyLocation
It takes text, so consistency is your job. Decide on a vocabulary, for example "knee" rather than a mix of "knee joint", "knees" and "genu", and keep it in one field in the CMS. The same discipline helps your internal search, your breadcrumbs and your condition and treatment SEO work.
preparation, howPerformed and followup
These three correspond to the sections that good treatment pages already have. Use them as summaries of those sections, in plain sentences, not as places to paste entire paragraphs. Keep them factual and neutral. Clinical instructions such as fasting times or medication changes must come from the clinical team's approved text. If the page says "your doctor will advise", the markup should not say anything more specific.
followup deserves care. Recovery language often drifts towards outcomes: "return to work in a week", "pain free". A marketer should not write those claims, and a schema field is not a loophole. If the provider's clinical team has approved a statement on the page, you may summarise it; otherwise leave the field empty.
status
The definition on schema.org describes the status of a study. It is not a hook for "now available" or "new". Omit it.
Properties inherited from MedicalEntity
Your procedure also inherits a few useful properties from MedicalEntity.
codetakes a MedicalCode: a code and the coding system it comes from. If your billing or clinical teams already use a recognised code set for the procedure, this gives you a precise identifier. Use only codes the clinical or coding team has confirmed for that exact procedure. A wrong code is worse than no code.relevantSpecialtytakes a MedicalSpecialty and ties the procedure to a department.guideline,recognizingAuthorityandstudyexist but are heavy. Add them only when the page visibly cites a guideline or study.
From Thing, add url, description (a one-sentence summary of the visible intro) and sameAs pointing to a stable external reference only when you are certain it describes the same procedure.




