How to Add DefinedTerm Schema for Glossary Pages
Mark up glossary entries with DefinedTerm schema so AI engines can cite your definitions directly. This guide walks you through each step, from preparation to implementation, so you can improve your Agent Experience Optimization and increase your visibility across AI search platforms like ChatGPT, Perplexity, and Gemini.
Prerequisites
Before You Start
- Basic understanding of HTML and your site's CMS
- Access to your website's source code or a tag manager
Step-by-Step Guide
Compile your list of terms and write clear, concise definitions for each
Take your time with this step to ensure accuracy. Proper execution here directly impacts how AI engines parse and cite your content. If you are unsure about implementation details, the Ultimate Guide to AEO provides additional context on best practices.
Before diving in, consider running a Free AEO Audit to establish your baseline metrics. This makes it easier to measure the impact of your changes.
Create a DefinedTermSet JSON-LD wrapping all terms with a set name and URL
Take your time with this step to ensure accuracy. Proper execution here directly impacts how AI engines parse and cite your content. If you are unsure about implementation details, the Ultimate Guide to AEO provides additional context on best practices.
Add individual DefinedTerm objects with name and description for each glossary entry
Take your time with this step to ensure accuracy. Proper execution here directly impacts how AI engines parse and cite your content. If you are unsure about implementation details, the Ultimate Guide to AEO provides additional context on best practices.
Include termCode or identifier properties if your terms have standard codes
Take your time with this step to ensure accuracy. Proper execution here directly impacts how AI engines parse and cite your content. If you are unsure about implementation details, the Ultimate Guide to AEO provides additional context on best practices.
Add the JSON-LD to your glossary page, either as one combined block or per-term blocks
Take your time with this step to ensure accuracy. Proper execution here directly impacts how AI engines parse and cite your content. If you are unsure about implementation details, the Ultimate Guide to AEO provides additional context on best practices.
Test AI engines by querying definitions of your terms to verify citation improvements
Take your time with this step to ensure accuracy. Proper execution here directly impacts how AI engines parse and cite your content. If you are unsure about implementation details, the Ultimate Guide to AEO provides additional context on best practices.
Pro Tips
- 1. Test your implementation across multiple AI platforms — what works for ChatGPT may behave differently on Perplexity or AI Overviews.
- 2. Use the Schema Generator to create properly structured data that reinforces your content's authority on this topic.
- 3. Monitor your citation dominance and answer share metrics after implementation to quantify results.
Common Mistakes to Avoid
Using incorrect schema types that don't match your content — always validate with Google's Rich Results Test.
Implementing schema markup but never testing it across AI platforms like ChatGPT and Perplexity.
Adding schema only to your homepage and neglecting inner pages that AI engines actually cite.
Next Steps
Ready to Put This Into Practice?
Start with a free audit to see exactly where your site stands, then apply this guide to improve your AI search visibility.
Get Your Free AEO Audit