ArtsAutosBooksBusinessEducationEntertainmentFamilyFashionFoodGamesGenderHealthHolidaysHomeHubPagesPersonal FinancePetsPoliticsReligionSportsTechnologyTravel

Writing Glossary Definitions

Updated on January 7, 2014

On Writing a Glossary

Glossary-Writing Terms
Glossary-Writing Terms | Source


Writing glossary definitions is not as straightforward as most people consider it to be: most glossaries suffer because of this misunderstanding. A glossary is not simply an informal dictionary, and so it must not be treated as such otherwise your readers may misunderstand what you are writing about.

This article talks about defining concepts for your glossary, provides rules to follow and tips for success, exercises to learn from, and a make-believe example of a glossary.

Intelligence Law Glossary

(via WikiMedia Commons.) An Example of a Large Formal Glossary: The U.S. Intelligence Law Glossary
(via WikiMedia Commons.) An Example of a Large Formal Glossary: The U.S. Intelligence Law Glossary | Source

Your Experience

Have you ever written a glossary?

See results

Defining a Concept for a Glossary

The first step to writing a good glossary definition is to make sure that you are defining—and not describing—a unique concept that will add value to your reader’s understanding of the document or topic for which you are writing the glossary.

Write your definitions in this general structure (modify to be realistic, please, don’t follow this blindly):

TERM: A [type of high-level concept] that [is different from other concepts in this way].

If you really think about it, almost all concepts are ultimately a subset--or literally a type of--one of these high-level concepts:

High-Level Concepts
...Physical object
server, client, ball, child, fish
...Cognitive/conceptual object
condition, status, feeling, opinion, thought
installing, upgrading, configuring, adjusting, childbirth, sneezing
software, hardware, cloth, water
security, prerequisite, Northern lights, electricity, gravity, magnetism, feeling, erosion (which might be instead/in addition defined as a process, depending on your use case)
toolkit, concatenation, continuum, set, series
government, education, mathematics, law enforcement
Other (Use very sparingly)
High-Level Concepts and Examples

Example Concepts

Physics is a type of science and so is biology. Types of physics include optics, thermodynamics, and both Newtonian and non-Newtonian physics. So, what is “science”, from our list of high-level concepts? It is a phenomenon, which is probably not necessary to mention in most glossaries.

If I’m defining the term “optics”, as in the science of optics not as in the physical lenses used to interact with light, I could write, “The physics of electromagnetic radiation—or light—and how it behaves and interacts with objects in the universe.” Then, I could go on to describe how “optics” is used in the text for which I am writing the glossary—giving examples as-appropriate. The level of technical detail you provide and the terminology you use should depend on the level of understanding of your audience (the readers of your glossary and the corresponding text for which you are writing the glossary).

Tips for Success

  • You can use words in your glossary that are not in your text—simply include the word/phrase used in your text and cross-reference the reader to where you have defined the core concept (“Term: See concept”).
  • You may need to modify the initial term you are defining to fit the purpose of the glossary. For example, instead of defining “access,” you might want to define “access privilege,” which is more specific and just as easy for the user of the glossary to locate.
  • You may need to add terms to make your work easier—this isn’t cheating, and you probably don’t need to worry if the exact term isn’t used in the main text for which you are developing the glossary. Use cross-references from the actual to the defined concept if in doubt!
  • Generally, the shorter the definition, the more correct it is.
  • The ideal definition is
    • one sentence/phrase long and
    • MUCH shorter than a corresponding description or explanation would be.

Glossary-Writing Rules

  • Write actual definitions, not descriptions, explanations, or examples, of how each concept is used in your work. However, once you have defined the term, you may also include descriptive/explanatory text if it is useful in helping the user to understand the concept. Cross-references to related terms help, too.
  • Use complete sentences if it makes sense, such as for a formal glossary for a formal piece. However, incomplete sentences, especially for the first defining statement, are acceptable in most glossaries.
  • Only define singular terms, never plurals, or your glossary will become messy and the concepts will become muddied. For example, “cattle” is really a plural meaning "a group of more than one bovine"—there is no singular word that is gender-neutral in the common vernacular. In this case, consider entering “cattle” but defining it as a group of cows and/or bulls, or better yet cross-reference the concepts “cow” and “bull”, where you actually define the terms, in a formal glossary.
  • Use lowercase for all words that are not proper nouns or acronyms, so that you can tell the difference between what should and shouldn't be capitalized.
  • Include cross-references to related terms. Links/page numbers aren't necessary for glossaries shorter than one page—just list the term the reader should go to for the definition. But, for longer glossaries, include page numbers and hyperlinks when appropriate to make it easy for your reader to find their information, which is the whole point of including a glossary!
  • Think about each glossary entry as a “concept”—an entity unique in all the world, defined here by you to differentiate it from all other concepts. If two “concepts” have identical definitions, then either you need to write more specific definitions or make the “two” concepts alternate names for each other. (Literally synonymous, not just "sort of synonymous" in the Roget’s Thesaurus sense of “synonymous”.)
  • Never use the term (or variations of it) to define itself.
    Incorrect: “Term: A term/synonym that….”
  • Don’t repeat the term at the beginning of the sentence that defines it.
    Incorrect: “Term: Term is a type of ….” Correct: “Term: A [type of higher-level, previously defined or an obvious concept]….”

The Twitter Glossary

(via WikiMedia Commons) An Example of a Visual Glossary--Very Creative!
(via WikiMedia Commons) An Example of a Visual Glossary--Very Creative! | Source

“Exercises for the Student”

If you can figure out how to define the following concepts, you’re on the right track:

  • What’s the difference between “number” and “numeral”?[i]
  • What’s the difference between “numeral” and “letter”?[ii]

Others to try on your own (answers are an exercise for the student):

  • “color” and “hue”
  • “smooth” and “flat”
  • “thick” and “dense”
  • “software” and “program”
  • “baby” and “infant”
  • “several” and “many”
  • “finger” and “thumb”

[i] “Number” is how many things there are that you’re talking about (it would fall into the category of “phenomena”); “numeral” is a graphic representation of “number”.

[ii] “Numeral” represents a number of objects; “letter” is one of the 26 ABCs that together form the alphabet of the English language.

How Did You Score?

Did you get the answers to the sample exercises correct? How confident are you that you could define the words in the "exercises for the student"?

See results

Sample Scenario: Lead-in to a Hypothetical Glossary for Software Product Documentation

This is a lexicon of the specific language needed to use the ACME system to DO SOMETHING.

Users of this system may be familiar with:

  • ACME’s previous systems
  • other similar government and industry systems
  • all—or none—of the above

For clarity and accuracy, then, this glossary defines terms used in the ACME System documentation, erring on the side of including significant concepts and terms, even “obvious” ones.

ACME System—Software produced by ACME Software, Inc., to DO SOMETHING for SOMEONE in the SOMETHING and SOMETHING ELSE industries.

Administrator role—The role of the person who is responsible for installing, updating, backing up, and ultimately maintaining ACME System software.

crash—The process in which the ACME System software fails in some way that causes the User’s computer to shut down unexpectedly, possibly generating one or more error messages during the process.

nonsense—A common condition in which a user attempts to accomplish something that ACME System software was not designed to do and is therefore unable to perform.

productivity—The measure of tasks the User accomplishes in a certain period of time that may or may not be quantitatively specified; if many tasks are completed in a short period of time, productivity may be said to be “high”; if fewer tasks are completed than expected for the period of time, productivity may be described as “low.” Note that productivity is affected by all of the following: User ability, network/system stability and traffic volume, computer processor speed, or ACME System capabilities for the particular task the User is performing.

role—A set of tasks, actions, and/or common patterns of behaviors exhibited by individuals interacting with ACME System software to accomplish a particular end-result; one of several general purposes for which a person may interact with ACME System software. User role and Administrator role are examples of this.

User role—The role of any person who is accessing and performing tasks using ACME System software.


Having written and edited 10,000+ glossary definitions in dozens of topic areas over my career as a technical writer, I have studied and honed the skill of writing effective glossary definitions to a fine point.

This article provided an easy method for you to follow to create effective, informative glossary definitions that your readers will be able to understand. Writing a high-quality glossary definition is a specialty technical writing form, but anyone can master it!

Follow this advice, within reason, and your glossaries will be easier to develop and your readers will be better able to understand each concept/term you are defining, which is the ultimate goal of creating a glossary.

About the Author

Information about the author, a list of her complete works on HubPages, and a means of contacting her are available over on ==>Laura Schneider's profile page. But wait--please leave ratings and any comments you have about this article so that it can be improved to best meet your needs. Thank you!

All text, photos, videos, and graphics in this document are Copyright © 2014 Laura D. Schneider unless indicated otherwise or unless in the public domain. All rights reserved. All trademarks and service marks are the property of their respective owners.


    0 of 8192 characters used
    Post Comment

    • Laura Schneider profile imageAUTHOR

      Laura Schneider 

      4 years ago from Minneapolis-St. Paul, Minnesota, USA

      Thanks everybody for your kind words! I'm glad you found this article interesting and/or helpful --rather than boring!! Cheers!

    • bethperry profile image

      Beth Perry 

      4 years ago from Tennesee

      What a fantastic Hub on the subject! Truly, you covered the subject in depth and yet presented it in an easy-to-understand way. Voting up.

    • DDE profile image

      Devika Primić 

      4 years ago from Dubrovnik, Croatia

      Interesting and creative thoughts here.

    • Laura Schneider profile imageAUTHOR

      Laura Schneider 

      4 years ago from Minneapolis-St. Paul, Minnesota, USA

      Thanks for your kind words and feedback! I'm glad you found this useful/interesting. Cheers!

    • Vellur profile image

      Nithya Venkat 

      4 years ago from Dubai

      Informative and useful information about the entire concept of "Glossary". Thank you for sharing. Voted up.

    • Laura Schneider profile imageAUTHOR

      Laura Schneider 

      4 years ago from Minneapolis-St. Paul, Minnesota, USA

      Wow, thanks for your compliments Eiddwen! Much appreciated!

    • Eiddwen profile image


      4 years ago from Wales

      Interesting and very useful.

      Voted up, across ,shared and looking forward to many more.



    This website uses cookies

    As a user in the EEA, your approval is needed on a few things. To provide a better website experience, uses cookies (and other similar technologies) and may collect, process, and share personal data. Please choose which areas of our service you consent to our doing so.

    For more information on managing or withdrawing consents and how we handle data, visit our Privacy Policy at:

    Show Details
    HubPages Device IDThis is used to identify particular browsers or devices when the access the service, and is used for security reasons.
    LoginThis is necessary to sign in to the HubPages Service.
    Google RecaptchaThis is used to prevent bots and spam. (Privacy Policy)
    AkismetThis is used to detect comment spam. (Privacy Policy)
    HubPages Google AnalyticsThis is used to provide data on traffic to our website, all personally identifyable data is anonymized. (Privacy Policy)
    HubPages Traffic PixelThis is used to collect data on traffic to articles and other pages on our site. Unless you are signed in to a HubPages account, all personally identifiable information is anonymized.
    Amazon Web ServicesThis is a cloud services platform that we used to host our service. (Privacy Policy)
    CloudflareThis is a cloud CDN service that we use to efficiently deliver files required for our service to operate such as javascript, cascading style sheets, images, and videos. (Privacy Policy)
    Google Hosted LibrariesJavascript software libraries such as jQuery are loaded at endpoints on the or domains, for performance and efficiency reasons. (Privacy Policy)
    Google Custom SearchThis is feature allows you to search the site. (Privacy Policy)
    Google MapsSome articles have Google Maps embedded in them. (Privacy Policy)
    Google ChartsThis is used to display charts and graphs on articles and the author center. (Privacy Policy)
    Google AdSense Host APIThis service allows you to sign up for or associate a Google AdSense account with HubPages, so that you can earn money from ads on your articles. No data is shared unless you engage with this feature. (Privacy Policy)
    Google YouTubeSome articles have YouTube videos embedded in them. (Privacy Policy)
    VimeoSome articles have Vimeo videos embedded in them. (Privacy Policy)
    PaypalThis is used for a registered author who enrolls in the HubPages Earnings program and requests to be paid via PayPal. No data is shared with Paypal unless you engage with this feature. (Privacy Policy)
    Facebook LoginYou can use this to streamline signing up for, or signing in to your Hubpages account. No data is shared with Facebook unless you engage with this feature. (Privacy Policy)
    MavenThis supports the Maven widget and search functionality. (Privacy Policy)
    Google AdSenseThis is an ad network. (Privacy Policy)
    Google DoubleClickGoogle provides ad serving technology and runs an ad network. (Privacy Policy)
    Index ExchangeThis is an ad network. (Privacy Policy)
    SovrnThis is an ad network. (Privacy Policy)
    Facebook AdsThis is an ad network. (Privacy Policy)
    Amazon Unified Ad MarketplaceThis is an ad network. (Privacy Policy)
    AppNexusThis is an ad network. (Privacy Policy)
    OpenxThis is an ad network. (Privacy Policy)
    Rubicon ProjectThis is an ad network. (Privacy Policy)
    TripleLiftThis is an ad network. (Privacy Policy)
    Say MediaWe partner with Say Media to deliver ad campaigns on our sites. (Privacy Policy)
    Remarketing PixelsWe may use remarketing pixels from advertising networks such as Google AdWords, Bing Ads, and Facebook in order to advertise the HubPages Service to people that have visited our sites.
    Conversion Tracking PixelsWe may use conversion tracking pixels from advertising networks such as Google AdWords, Bing Ads, and Facebook in order to identify when an advertisement has successfully resulted in the desired action, such as signing up for the HubPages Service or publishing an article on the HubPages Service.
    Author Google AnalyticsThis is used to provide traffic data and reports to the authors of articles on the HubPages Service. (Privacy Policy)
    ComscoreComScore is a media measurement and analytics company providing marketing data and analytics to enterprises, media and advertising agencies, and publishers. Non-consent will result in ComScore only processing obfuscated personal data. (Privacy Policy)
    Amazon Tracking PixelSome articles display amazon products as part of the Amazon Affiliate program, this pixel provides traffic statistics for those products (Privacy Policy)