The Ultimate Substance
Schema Generator
Any matter of defined composition that has discrete existence, whose origin may be biological, mineral or chemical.
Magic Build
Paste your URL below and our AI will automatically fill the Substance fields for you.
Configuration
Live GeneratorWhy use Substance?
Output Panel
Want to automate this?
Connect your site to SchemaGen and our AI will automatically extract and deploy schemas for you. No manual coding required.
Launch AI GeneratorWhat is Substance Schema?
Any matter of defined composition that has discrete existence, whose origin may be biological, mineral or chemical.
Google uses Substance structured data to understand the content and context of your pages. When correctly implemented, this schema can unlock rich results in Google Search — enhancing your listing with additional information that dramatically improves visibility and click-through rates.
Why Add Substance Structured Data?
Appear in Rich Results
Structured data helps Google show enhanced results for your pages in search — including stars, prices, FAQs, and more.
Boost Click-Through Rate
Rich snippets can increase CTR by up to 30% compared to plain search results — more clicks with the same ranking.
Feed AI Search Engines
AI answer engines like Perplexity and Google SGE use structured data to verify and cite facts from your content.
How to Implement Substance JSON-LD
Generate
Use the form above to fill in your details and generate valid Substance JSON-LD markup in seconds.
Copy
Copy the generated JSON-LD output code with one click — it's already formatted and ready to deploy.
Deploy
Paste the code into your <head> tag, or use SchemaGen's SDK to deploy without touching code.
Want to skip steps 2 & 3? Connect SchemaGen's SDK to deploy directly from the dashboard.
Properties You Can Include
Substance schema supports the following schema.org properties. Required fields are the minimum Google needs to consider your markup valid; recommended fields unlock richer search result appearances.
| Property | Description | Expected Type | Status |
|---|---|---|---|
| activeIngredient | An active ingredient, typically chemical compounds and/or biologic substances. | Text | Optional |
| additionalType | An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. Typically the value is a URI-identified RDF class, and in this case corresponds to the use of rdf:type in RDF. Text values can be used sparingly, for cases where useful information can be added without their being an appropriate schema to reference. In the case of text values, the class label should follow the schema.org style guide. | Text, URL | Optional |
| alternateName | An alias for the item. | Text | Optional |
| code | A medical code for the entity, taken from a controlled vocabulary or ontology such as ICD-9, DiseasesDB, MeSH, SNOMED-CT, RxNorm, etc. | MedicalCode | Optional |
| description | A description of the item. | Text, TextObject | Optional |
| disambiguatingDescription | A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation. | Text | Optional |
| funding | A Grant that directly or indirectly provide funding or sponsorship for this item. See also ownershipFundingInfo. | Grant | Optional |
| guideline | A medical guideline related to this entity. | MedicalGuideline | Optional |
| identifier | The identifier property represents any kind of identifier for any kind of Thing, such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See [background notes](/docs/datamodel.html#identifierBg) for more details. | PropertyValue, Text, URL | Optional |
| image | An image of the item. This can be a URL or a fully described ImageObject. | ImageObject, URL | Recommended |
| legalStatus | The drug or supplement's legal status, including any controlled substance schedules that apply. | DrugLegalStatus, MedicalEnumeration, Text | Optional |
| mainEntityOfPage | Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See [background notes](/docs/datamodel.html#mainEntityBackground) for details. | CreativeWork, URL | Optional |
| maximumIntake | Recommended intake of this supplement for a given population as defined by a specific recommending authority. | MaximumDoseSchedule | Optional |
| medicineSystem | The system of medicine that includes this MedicalEntity, for example 'evidence-based', 'homeopathic', 'chiropractic', etc. | MedicineSystem | Optional |
| name | The name of the item. | Text | Required |
| owner | A person or organization who owns this Thing. | Organization, Person | Optional |
| potentialAction | Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role. | Action | Optional |
| recognizingAuthority | If applicable, the organization that officially recognizes this entity as part of its endorsed system of medicine. | Organization | Optional |
| relevantSpecialty | If applicable, a medical specialty in which this entity is relevant. | MedicalSpecialty | Optional |
| sameAs | URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Wikidata entry, or official website. | URL | Optional |
Example Substance JSON-LD
Here's what valid Substance structured data looks like with sample values filled in. Use the generator above to replace these with your own data.
{
"@context": "https://schema.org",
"@type": "Substance",
"name": "Example Substance",
"image": "https://example.com/images/example.jpg",
"url": "https://example.com/page",
"activeIngredient": "Example activeIngredient",
"additionalType": "Example additionalType",
"alternateName": "Example alternateName",
"code": {
"@type": "MedicalCode",
"name": "Example MedicalCode",
"image": "https://example.com/images/example.jpg",
"url": "https://example.com/page"
},
"description": "A sample description for this Substance."
}Validate Your Substance Schema
Once deployed, validate your schema is working correctly with our free audit tool. Paste your URL and we'll check for errors, missing properties, and Google Rich Result eligibility.
Check your Substance schema for errors and Rich Result eligibility