In beta, with limited placesOpen to everyone in Q1 2027

↑↓ to move · Enter to open · Esc to close

Structured data

What is DefinedTerm in Schema.org?

DefinedTerm is the Schema.org type that describes a word, name, acronym or phrase with a formal definition, such as a glossary entry or a category with a code. It carries the term in name, the definition in description and, if it has one, its code in termCode, and it can belong to a DefinedTermSet. Google does not use it for any rich result.

Written by
Reviewed by
Published 6 min read
Takeaway:

Key takeaways

  • DefinedTerm marks up a term with its definition; DefinedTermSet marks up the glossary, dictionary or classification that contains it.
  • Schema.org also designed it for product categories with a code, such as the United Nations UNSPSC classification, and it warns: for a specific product, the type is Product.
  • Google does not include DefinedTerm in its list of structured data features: it has no rich result of its own.
  • In a store it belongs on a glossary page, a materials guide or a taxonomy with codes, not on the product page.

If you open the code of a glossary page and find "@type": "DefinedTerm", you are looking at the Schema.org type that says "this is a word and this is its definition." It does not describe a product or a company, but a term in a vocabulary. A store cares in two cases: when it publishes content that defines things (a fabric glossary, a materials guide, a size chart with what each size means) and when it organizes its catalog with categories that have codes. In both, DefinedTerm is the standard way to say it with structured data. What it does not do is earn you a special result on Google, and it is worth knowing that before you spend time on it.

How it works

Schema.org defines DefinedTerm as a word, name, acronym or phrase with a formal definition, and says where it is used: in classifications by category or topic, in glossaries and dictionaries and in types of product or work. It is an intangible type (Thing > Intangible > DefinedTerm), and the page itself gives the usage instructions: the term goes in name, the alphanumeric code, if it has one, in termCode, the definition in description, and the subject the term is about in about.⁠[1]Schema.org. DefinedTerm

A term usually lives inside a set. That is what DefinedTermSet is for: a set of defined terms, for example a set of categories, a classification scheme, a glossary, a dictionary or an enumeration. Unlike the term, the set is a work (CreativeWork), and it lists its terms with hasDefinedTerm.⁠[2]Schema.org. DefinedTermSet The term points to the set with inDefinedTermSet, which accepts either a DefinedTermSet described in the same markup or a URL.⁠[1]Schema.org. DefinedTerm

For classifications with codes there is a more specific type: CategoryCode, which inherits everything from DefinedTerm and adds codeValue, a short code that identifies the value, and inCodeSet, the code set it belongs to.⁠[3]Schema.org. CategoryCode Schema.org's example for a product category is clear: a DefinedTerm named "Photovoltaic module," with the code 261315XX and, as its set, the United Nations products and services classification (UNSPSC). Right next to it comes the rule that separates the two worlds: for a specific product or service, use the Product type.⁠[1]Schema.org. DefinedTerm

According to the data the Schema.org page itself shows, taken from Google's index in August 2026, DefinedTerm is used on between 10,000 and 100,000 domains.⁠[1]Schema.org. DefinedTerm

What Google does with it

Google publishes the list of structured data types that unlock features in its Search, and DefinedTerm is not on it.⁠[4]Google Search Central. Structured data markup that Google Search supports There are no glossary or definition rich results. That does not make the markup useless: Google explains that it uses the structured data it finds on the web to understand the content of the page and to gather information about the web and the world in general.⁠[5]Google Search Central. Introduction to structured data markup in Google Search A well-built DefinedTerm tells any machine that reads it, without ambiguity, which term the page defines and what its definition is. What you cannot expect is to see it in the results.

In a store

This very glossary works as a real example, because every entry carries its own DefinedTerm. This page's, trimmed, looks like this:

{
  "@type": "DefinedTerm",
  "@id": "https://clione.ai/glossary/definedterm/#term",
  "name": "DefinedTerm",
  "description": "DefinedTerm is the Schema.org type that describes a word…",
  "url": "https://clione.ai/glossary/definedterm/",
  "inLanguage": "en",
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "inDefinedTermSet": {
    "@type": "DefinedTermSet",
    "@id": "https://clione.ai/glossary/#termset",
    "name": "SEO and AI search glossary for ecommerce"
  }
}

It reads like this: the term and its definition are the same ones you see above, in the title and in the lead, and the set carries a fixed @id, so every entry points to the same glossary without describing it each time. In the full JSON-LD, the page declares this term as its main topic, with mainEntity.

In a store, the most natural use is a fictional example like this one: a home linens store publishes a "Fabric glossary" page with entries like "Washed linen" or "Percale," each with its visible definition. Each entry is marked up as a DefinedTerm with name and description, all of them point with inDefinedTermSet to the same DefinedTermSet, and the glossary page lists them with hasDefinedTerm. If the store classifies its catalog with a code standard, the category can go as a CategoryCode with its codeValue. What does not change is the product page: the product being sold is still a Product.

Warning:

What people often get wrong

Using DefinedTerm to mark up a product, or a product feature, on the product page. Schema.org says it in its own example: a DefinedTerm is for a category with its code, and for a specific product the type is Product.⁠[1]Schema.org. DefinedTerm And Google asks that markup describe what the visitor sees on the page:⁠[6]Google Search Central. General structured data guidelines a DefinedTerm with a definition that is not written anywhere describes something that does not exist.

How to check it

  1. Search for DefinedTerm in the source code of your glossary page or your materials guide.
  2. Compare each name and each description with the visible text. They have to say the same thing as the page, in the same words.⁠[6]Google Search Central. General structured data guidelines
  3. Follow each term's inDefinedTermSet to its set. If it is an @id, it has to match the DefinedTermSet's letter for letter.
  4. Run the URL through a schema validator to catch syntax errors. Do not expect Google's Rich Results Test to flag it as a result: DefinedTerm is not among its features.⁠[4]Google Search Central. Structured data markup that Google Search supports
  5. Look at the product page separately. If you find a DefinedTerm where there should be a Product, it is surplus.

An entity is the thing: a brand, a material, a place, something that exists and can be identified without ambiguity. A DefinedTerm is the word that names it inside a vocabulary, with the definition that vocabulary gives it. Linen is an entity; "Washed linen," with the definition from your glossary, is a defined term. Schema.org connects them with one property: about, which says what the term is about.⁠[1]Schema.org. DefinedTerm The same term can be defined in two different glossaries and talk about the same entity.

To go further, product taxonomy explains how a catalog is organized into categories, and the structured data reading path orders the rest of the types.

Synonyms

English
DefinedTerm schema, defined term markup
Español
término definido, marcado de glosario

Sources

  1. [1] Schema.org. DefinedTerm. Accessed . ↑ ↑ ↑ ↑ ↑ ↑
  2. [2] Schema.org. DefinedTermSet. Accessed . ↑
  3. [3] Schema.org. CategoryCode. Accessed . ↑
  4. [5] Google Search Central. Introduction to structured data markup in Google Search. Accessed . ↑
  5. [6] Google Search Central. General structured data guidelines. Accessed . ↑ ↑

Change history

  • First English version.

This definition is published under CC BY 4.0. Reuse this definition freely, crediting Clione with a link to this page.

Make your catalog easy for bots to read

Clione fills every product page with what bots read best: the JSON-LD graph with its structured data, the meta description and the FAQs. You review and press Push; then we check your live store so it all stays published.