Skip to main content
U.S. flag

An official website of the United States government

Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

Unified Medical Language System® (UMLS®)

UMLS - Frequently Asked Questions

What is the UMLS?

The UMLS, or Unified Medical Language System, is a set of files and software that brings together many health and biomedical vocabularies and standards to enable interoperability between computer systems.

You can use the UMLS to enhance or develop applications, such as electronic health records, classification tools, dictionaries and language translators.

Where can I get more information about the UMLS?

Get Started

Begin learning about the UMLS with these tools:

Technical Documentation

The UMLS Reference Manual provides an overview of the UMLS and:

  • Metathesaurus overview and organization (concepts, relationships, attributes)
  • Details about the RRF data files (columns, rows, and descriptions)

Vocabulary Documentation

MetamorphoSys (Local Installation of the UMLS)

Listserv

UMLS users are encouraged to subscribe to this list, to share their experiences with, or seek advice from the UMLS community on using UMLS resources. NLM also uses this forum to distribute official announcements about UMLS products and services.

  • To subscribe, send an e-mail to: listserv@list.nih.gov containing the following message: SUBSCRIBE UMLSUSERS-L <your full name>
  • To post a message to the list AFTER subscribing, send an e-mail to: UMLSUSERS-L@list.nih.gov
  • To access subscription information and list archives, go to: UMLSUSERS-L Listserv Web page

How often is the UMLS released?

The UMLS is updated in May and November of each year. The May release is the AA release (ex. 2022AA) and the November release is the AB Release (ex. 2022AB).

Where are the release notes?

The Release homepage includes release notes, bugs, metadata, and statistics for the latest version of the UMLS.

How do I sign up for a UMLS license?

  1. Please sign up for a new UMLS Terminology Services (UTS) account with your preferred identity provider at the UTS Sign Up page.
  2. Complete and submit the UMLS license request form. NLM will send the license approval e-mail within 5 business days after reviewing your authenticated license request.
  3. You will sign in using your identity provider credentials to download files or access web interfaces that require UTS authentication such as the UTS, VSAC, SNOMED CT, or RxNorm.

How do I access the UMLS?

You must sign up for a license to access the UMLS.

To request a license, click "Sign Up" on the UTS homepage. Additional information can be found on the UMLS License page. You will signup/sign in using your identity provider credentials to download files or access web interfaces that require UTS authentication such as the UTS, VSAC, SNOMED CT, and RxNorm.

The UMLS Terminology Services (UTS) provides three ways to access the UMLS.

1) Web Browsers

You can search the data through UTS applications:

  • Metathesaurus Browser - Retrieve UMLS concept information, including CUIs, semantic types, and synonymous terms.
  • Semantic Network Browser - View the names, definitions, and hierarchical structure of the Semantic Network.

2) Local Installation

To install the UMLS on your computer, download the files through the UTS. The MetamorphoSys tool, included with the downloaded files, allows you to customize the UMLS according to your needs. You can then load your customized data into your own database system, such as MySQL or Oracle, or you may browse your data using the MetamorphoSys RRF browser.

3) Web Services APIs

You can use our application programming interfaces (APIs) to query the UMLS data within your own application.

I usually sign in with a UTS username and password. What happened to that?

We are no longer supporting username/password sign in. Instead, you will sign in with your email address using one of the identity providers above.

I selected "Microsoft" and tried to sign in using my work email address, but it didn't work. What should I do?

Your organization may not allow you to sign in to external services using your Microsoft credentials. Try one of the following options:

  • Create an account with Login.gov by going to the Login.gov sign up page. Then select "Login.gov" on this page.
  • Choose another identity provider.

What if I want to sign up for a UTS account / license but I don't have an account with any of the identity providers listed above?

  1. Create an account with Login.gov by going to the Login.gov sign up page. Then go to the UTS sign up page, select Login.gov, and sign in if prompted.
  2. Then go to the UTS sign up page, select Login.gov, and sign in if prompted.
  3. Complete and submit the UMLS license request form. NLM will send the license approval e-mail within 5 business days after reviewing your authenticated license request.

I am a NIH employee. Which option should I choose?

Choose "NIH Employee" and sign in with your PIV card or NIH credentials.

ow do I edit information I submitted in my license request? How do I edit my profile?

After you receive an approval email, login to the UTS and go to your profile page then select "Edit profile" in the upper left corner to make your updates.

I have a question that isn't covered here. Who can I ask?

If you are encountering errors not covered here, first try clearing your browser cache and cookies or try a different web browser. If that does not resolve your problem, submit your question to the NLM Help Desk. Be sure to describe your issue in detail so that we can provide the best possible answer.

How do I search within the UMLS?

You can search the data through UTS applications:

You can search the data through your local installation:

  • RRF Browser - Retrieve UMLS concept information, including: CUIs, semantic types, and synonymous terms from your installed data subset.

How do I search within the UMLS?

There are two ways to access the downloads:

What terminology and mapping files are available for download?

Go to the Downloads Homepage to view available downloads.

What is the UTS?

The UMLS Terminology Services (UTS) Web site gives you access to the UMLS browsers, downloads, and APIs.

How can I submit requests for changes or additions to the UMLS?

You can request changes or additions to the UMLS by contacting NLM Customer Support. If additions are specific to the source, you should contact the terminology source provider. Contact information is available in Appendix 1 of the License agreement.

Are there any fees for the UMLS license?

  • There are no fees for the UMLS Metathesaurus License
  • Appendix 2 of the license, the SNOMED CT Affiliate License Agreement, refers to fees for the use of SNOMED CT in a non-Member country/territory. Contact SNOMED International with any questions regarding fees for use before signing up for a UMLS license.

Is an organizational license available?

Licenses are registered to individuals. There are no organizational or enterprise licenses.

Does everyone in my organization need a license?

NLM requires at least once licensee per organization. However, it is fine to have multiple licensees from the same organization. Each person who requires access to the browsers and/or downloads must have their own license. We do not encourage users to share account information with one another.

Are there special rules for vendors or other commercial organizations?

There is not a separate license for commercial organizations. However, if your product incorporates data from the UMLS, you must have a license. Additionally, we require that your clients have a license as well. The same license and rules apply to all users.

Where can I get a copy of the license?

View the PDF of the license agreement.

I have questions about a specific vocabulary that are not covered by the license agreement.

Contact the content provider directly to ensure that your use is covered by the UMLS License. Appendix 1 of the license lists contact information for each vocabulary.

What is the UMLS Annual Report?

As part of the license agreement, you agree to provide NLM with a yearly report of how you used the UMLS. The report is due every January. NLM will send several e-mail reminders in January and you will complete the report through your UTS profile.

What is the SNOMED CT Affiliate Report?

As mentioned in the SNOMED CT Affiliate License Agreement, you agree to report to the SNOMED International on your usage of SNOMED CT in non-Member countries. This report is imbedded within the UMLS Annual Report. Complete details are available from SNOMED International.

Other NLM Terminologies

Contact Us

We welcome any questions and comments via our contact form.


Last Reviewed: May 18, 2021