XooCode(){

MedicalStudy

MedicalStudy is a MedicalEntity subtype for any kind of medical research study. It adds 5 properties: healthCondition, sponsor, status (accepts MedicalStudyStatus, EventStatusType, or Text), studyLocation, studySubject. Its direct subtypes are MedicalObservationalStudy and MedicalTrial.

Full example of schema.org/MedicalStudy json-ld markup

The markup is verified as valid with Rich Results Test from Google.

Highlight legend:Required by GoogleRecommendedOptional
schema.org/MedicalStudy
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "MedicalStudy",
  "name": "Xoo Code Structured Documentation Training Study",
  "description": "Multi-site observational study measuring documentation accuracy in hospital coding teams before and after a JSON-LD training intervention.",
  "status": "https://schema.org/Recruiting",
  "healthCondition": { "@type": "MedicalCondition", "name": "N/A - non-patient observational study" },
  "sponsor": { "@type": "Organization", "name": "Xoo Code Foundation" },
  "studyLocation": { "@type": "AdministrativeArea", "name": "Northeastern United States" },
  "studySubject": { "@type": "MedicalEntity", "name": "Hospital documentation teams" },
  "startDate": "2026-02-01",
  "endDate": "2027-12-31",
  "identifier": "XCF-OBS-2026-004"
}
</script>

MedicalStudyStatus enum

Schema.org/MedicalStudyStatus has 10 members: ActiveNotRecruiting, Completed, EnrollingByInvitation, NotYetRecruiting, Recruiting, ResultsAvailable, ResultsNotAvailable, Suspended, Terminated, Withdrawn. These mirror the ClinicalTrials.gov status vocabulary.

Minimal valid version

The smallest markup that still produces a valid MedicalStudy entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/MedicalStudy (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "MedicalStudy",
  "name": "Xoo Code Structured Documentation Training Study",
  "status": "https://schema.org/Recruiting",
  "sponsor": { "@type": "Organization", "name": "Xoo Code Foundation" }
}
</script>

Google rich results this unlocks

Markup matching this example makes your page eligible for the following Google Search rich results. The primary target drives the required / recommended property classification in the advanced code block above.

  • No dedicated rich result (used by clinical trial aggregators)
    Google docs

Common MedicalStudy mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

  1. 01

    status as free text

    Wrong
    "status": "enrolling" or "open"
    Right
    "status": "https://schema.org/Recruiting"

    MedicalStudyStatus is an enum with 10 exact members. Free text is silently dropped by clinical-trial aggregators that depend on the enum.

  2. 02

    Using MedicalStudy when MedicalTrial or MedicalObservationalStudy fits

    Wrong
    Bare MedicalStudy for a randomised controlled trial
    Right
    MedicalTrial for interventional trials; MedicalObservationalStudy for cohort/case-control

    Trials and observational studies have different regulatory and methodological implications. Use the specific subtype so downstream readers can filter and classify correctly.

Schema properties in this example

MedicalStudyMedicalEntitynamedescriptionstatusMedicalStudyStatusRecruitingCompletedTerminatedActiveNotRecruitinghealthConditionMedicalConditionsponsorOrganizationstudyLocationAdministrativeAreastudySubjectstartDateendDateidentifierMedicalObservationalStudyMedicalTrial

About the example data

A fictional Xoo Code Medical observational study on the efficacy of structured data training for hospital documentation teams.

Comments

Loading comments...

Leave a comment