How to Add DefinedTerm Schema for Glossary Pages

Difficulty: Easy
20 minutes
Category: Schema

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

1

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.

2

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.

3

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.

4

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.

5

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.

6

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

Common Mistakes to Avoid

1

Using incorrect schema types that don't match your content — always validate with Google's Rich Results Test.

2

Implementing schema markup but never testing it across AI platforms like ChatGPT and Perplexity.

3

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