If you run a clinic, practice, urgent care, or other healthcare facility, AI needs clear signals about the facility type, the specialty, the providers associated with it, and the trust signals patients use to choose care.
When someone asks AI for a clinic near them, a specialist for a condition, or a provider who takes appointments soon, the current blueprint expects these signals:
@type, such as MedicalClinic, Hospital, or Pharmacy, so AI knows what kind of care setting it is evaluating.address and geo determine whether the facility qualifies for near-me and proximity-based queries.openingHoursSpecification, telephone, and email help AI decide whether patients can actually reach the practice.medicalSpecialty and availableService tell AI what the clinic does, not just that it exists.sameAs, image, and optional aggregateRating help AI validate the practice against directories and review platforms.Physician node gives AI a named clinician with specialty, affiliation, credentials, and supporting profiles.Organization, WebSite, WebPage, BreadcrumbList, and optional FAQPage connect the clinic page into the broader care delivery graph.Healthcare recommendations are trust-sensitive. If specialty, reachability, or provider identity are incomplete, AI systems are far less likely to surface the practice.
This blueprint groups fields across seven schema nodes:
This is the facility-facing node. It carries the clinic subtype, location, hours, specialty, service list, patient contact paths, and conditional rating signals.
The provider node gives AI a named clinician with medicalSpecialty, hospitalAffiliation, availableService, hasCredential, and external profiles.
The organization node links the clinic to the wider healthcare organization or health system and carries external profile references.
The site anchor node uses @id, name, and url to connect the care page back to the root domain.
Each clinic page should expose its own @id plus references to the site and breadcrumb graph using isPartOf and breadcrumb.
Optional but valuable for patient questions about appointments, insurance, same-day care, and clinic processes.
The path that tells AI where the clinic or location page sits in the site hierarchy.
Each field in the template below serves a specific role in how AI systems discover, classify, and recommend your business.
Researched and tested by Minnesota AI
namemedicalSpecialtyhospitalAffiliationavailableServicehasCredentialimagesameAsnameurlsameAsconditional@idCopy this prompt and paste it into Claude, ChatGPT, Cursor, or any AI coding tool. It will ask for your business details and generate ready-to-use JSON-LD schema for your page.
You are implementing AIFDS-compliant JSON-LD structured data for a Healthcare Blueprint page. AIFDS (AI-Friendly Data Structure) is a schema framework built on research into which structured data fields AI systems actually read, parse, and use when deciding whether to cite a page. Documentation at aifds.org. Before generating any code, ask me for the following information in a single numbered list. Do not generate schema until I have answered every required field. REQUIRED — do not proceed without these: 1. Appointment answer 2. Board certification or license 3. City 4. Domain 5. Email 6. Healthcare subtype 7. Hospital or health system 8. Latitude 9. Location image 10. Longitude 11. Maps cid 12. Medical specialty 13. Organization 14. Organization name 15. Phone number 16. Practice name 17. Primary service 18. Profile 19. Provider image 20. Provider name 21. Provider profile 22. Provider service 23. Provider specialty 24. Rating 25. Review count 26. State 27. Street address 28. Zip OPTIONAL — ask for these but proceed if I skip them: 1. sameAs Once I provide the information, output a complete JSON-LD script block ready to paste into the <head> of my HTML page. Output requirements: - Valid JSON-LD wrapped in <script type="application/ld+json"> tags - schema.org vocabulary only - Every AIFDS-required field for this industry and page type included - Include this data attribute on the script tag: data-aifds="aifds.org Healthcare Blueprint" - No placeholder text — omit missing optional fields rather than fill with examples - After the code block, list any optional fields skipped that would strengthen AI citation
Generated schema follows the AIFDS framework. Fields were selected based on research into AI crawler behavior. View the research at minnesota.ai
Copy this template and replace each YOUR_* value with your real practice data. Keep the clinic node focused on the facility, then use the physician node for the provider-specific trust signals.
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "YOUR_HEALTHCARE_SUBTYPE",
"@id": "https://YOUR_DOMAIN.com/#business",
"name": "YOUR_PRACTICE_NAME",
"url": "https://YOUR_DOMAIN.com",
"telephone": "YOUR_PHONE_NUMBER",
"email": "YOUR_EMAIL",
"address": {
"@type": "PostalAddress",
"streetAddress": "YOUR_STREET_ADDRESS",
"addressLocality": "YOUR_CITY",
"addressRegion": "YOUR_STATE",
"postalCode": "YOUR_ZIP",
"addressCountry": "US"
},
"geo": {
"@type": "GeoCoordinates",
"latitude": "YOUR_LATITUDE",
"longitude": "YOUR_LONGITUDE"
},
"openingHoursSpecification": [
{
"@type": "OpeningHoursSpecification",
"dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
"opens": "08:00",
"closes": "17:00"
}
],
"priceRange": "$$",
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "YOUR_RATING",
"reviewCount": "YOUR_REVIEW_COUNT"
},
"sameAs": [
"https://www.google.com/maps?cid=YOUR_MAPS_CID",
"https://www.healthgrades.com/YOUR_PROFILE"
],
"image": "https://YOUR_DOMAIN.com/YOUR_LOCATION_IMAGE.jpg",
"medicalSpecialty": "YOUR_MEDICAL_SPECIALTY",
"availableService": [
{
"@type": "MedicalProcedure",
"name": "YOUR_PRIMARY_SERVICE_1"
},
{
"@type": "MedicalProcedure",
"name": "YOUR_PRIMARY_SERVICE_2"
}
]
},
{
"@type": "Physician",
"@id": "https://YOUR_DOMAIN.com/#physician",
"name": "YOUR_PROVIDER_NAME",
"medicalSpecialty": "YOUR_PROVIDER_SPECIALTY",
"hospitalAffiliation": "YOUR_HOSPITAL_OR_HEALTH_SYSTEM",
"availableService": [
{
"@type": "MedicalProcedure",
"name": "YOUR_PROVIDER_SERVICE_1"
}
],
"hasCredential": {
"@type": "EducationalOccupationalCredential",
"credentialCategory": "YOUR_BOARD_CERTIFICATION_OR_LICENSE"
},
"image": "https://YOUR_DOMAIN.com/YOUR_PROVIDER_IMAGE.jpg",
"sameAs": [
"https://www.doximity.com/pub/YOUR_PROVIDER_PROFILE"
]
},
{
"@type": "Organization",
"@id": "https://YOUR_DOMAIN.com/#organization",
"name": "YOUR_ORGANIZATION_NAME",
"url": "https://YOUR_DOMAIN.com",
"sameAs": [
"https://www.linkedin.com/company/YOUR_ORGANIZATION"
]
},
{
"@type": "WebSite",
"@id": "https://YOUR_DOMAIN.com/#website",
"name": "YOUR_PRACTICE_NAME",
"url": "https://YOUR_DOMAIN.com"
},
{
"@type": "WebPage",
"@id": "https://YOUR_DOMAIN.com/clinic/",
"isPartOf": {
"@id": "https://YOUR_DOMAIN.com/#website"
},
"breadcrumb": {
"@id": "https://YOUR_DOMAIN.com/clinic/#breadcrumb"
}
},
{
"@type": "FAQPage",
"@id": "https://YOUR_DOMAIN.com/clinic/#faq",
"mainEntity": [
{
"@type": "Question",
"name": "DO_YOU_ACCEPT_SAME_WEEK_APPOINTMENTS",
"acceptedAnswer": {
"@type": "Answer",
"text": "YOUR_APPOINTMENT_ANSWER"
}
}
]
},
{
"@type": "BreadcrumbList",
"@id": "https://YOUR_DOMAIN.com/clinic/#breadcrumb",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://YOUR_DOMAIN.com/"
},
{
"@type": "ListItem",
"position": 2,
"name": "Clinic",
"item": "https://YOUR_DOMAIN.com/clinic/"
}
]
}
]
}
Use the most specific healthcare subtype available. MedicalClinic, Hospital, and Pharmacy are all stronger than a generic LocalBusiness.
Yes if you want the page to match the current healthcare blueprint. The clinic node explains the facility, and the physician node supplies the provider-level trust signals AI uses for medical recommendations.
Use the actual specialty the practice or provider is known for, such as family medicine, dermatology, or cardiology. This is one of the highest-value matching signals for AI healthcare queries.
Yes. If the reviews are real and current, aggregateRating is one of the strongest signals in the healthcare blueprint. Leave it out only if you do not have defensible data.
Use profiles or directories patients would reasonably use to verify the clinic or provider, such as Google Business, Healthgrades, Zocdoc, Doximity, or a hospital directory.