CQL - Clinical Quality Language

Clinical Quality Language (CQL) is a Health Level Seven International (HL7) authoring language standard that’s intended to be human readable. It is part of the effort to harmonize standards used for electronic clinical quality measures (eCQMs) and clinical decision support (CDS). CQL provides the ability to express logic that is human readable yet structured enough for processing a query electronically. CQL is the expression logic used in Health Quality Measure Format (HQMF) beginning with the eCQMs intended for implementation in calendar year 2019. CQL replaces the logic expressions previously defined in the Quality Data Model (QDM) and QDM (beginning with v5.3) includes only the conceptual model for defining the data elements (the data model). Measure authors with access to the Measure Authoring Tool (MAT) can use the tool to author measures using CQL. Visit the MAT webpage for more information.  

CQL allows for a more modular, flexible, and robust expression of the logic. It allows logic to be shared between measures and with decision support. Learn more about the advantages of CQL from the Benefits of CQL presentation.

Find the CQL Standards

CQL Standards are located on the HL7 Website: CQL Specification.

eCQM Known Issues (Standards, Tooling, and Measure Authoring) are found on the CQL Formatting and Usage Wiki.

Find the CQL-based QDM Reference

QDM v5.3 and v5.4 for use with Clinical Quality Language (CQL) are found on the QDM page.

CQL Style Guide provides examples to standardize expression of measure concepts across eCQMs and define a uniform “look and feel” to eCQM logic using CQL. The guide focuses on a set of common best practices implemented across CQL-based eCQMs in CMS reporting programs and also promotes the use of consistent language within the framework of CQL, including libraries, aliases, definitions, functions and conventions.

CQL Formatting and Usage Wiki serves as a collaborative workspace for the development of CQL formatting conventions and usage patterns for the representation of logic within quality measures. All users have edit rights to be able to submit edits, add comments and concerns. Items on the Wiki are a work in progress and subject to change. 

CQL Online is an open source educational tool that provides a "sandbox" where eCQM developers and implementers can "play" with CQL. The tool allows users to get a feel for what CQL looks like and how to write proper expressions in this new and powerful language. More specifically, CQL Online is a syntax directed editor for writing expressions in CQL. 

GitHub Tools Repository contains tools in support of CQL.

Visit the CQL Q&As page to review common questions and answers on CQL.

Visit the CQL Formatting and Usage Wiki. The Wiki serves as a collaborative workspace for the development of CQL formatting conventions and usage patterns for the representation of logic within quality measures. All users have edit rights to be able to submit edits, add comments and concerns. Items on the Wiki are a work in progress and subject to change. The Wiki also includes a listing of known eCQM issues (Standards, Tooling, and Measure Authoring), users can “watch” the eCQM Known Issues page to receive email notification as issues are added and updated. 

Join the CQL Technical Chat Discussion.

Participate in an upcoming HL7 CDS Workgroup call. This Work Group discusses CQL in the HL7 CQF-on-FHIR forum.

Review the CQL STU comments on the HL7 website.

Submit feedback on CQL issues, comments, and questions to the ONC JIRA CQL Issue Tracker.

Last Updated: October 16, 2018