CQL (Clinical Quality Language)

fhir technical technical fhirclinicalinteroperabilityhealthcare

Acronym for: Clinical Quality Language

Source: HL7 System: http://hl7.org/fhir/uv/cql Code: CQL Reviewed: 29/01/2026 License: CC-BY-4.0

CQL (Clinical Quality Language)

One-sentence definition: CQL (Clinical Quality Language) is an HL7 standard for expressing clinical logic — quality measure criteria, decision support rules, and eligibility definitions — in a structured, human-readable language that can be executed against FHIR data.

Full Definition

Clinical knowledge has traditionally been expressed in natural language — measure specifications in PDF documents, CDS rules in proprietary system configurations, eligibility criteria in spreadsheets. This makes the logic hard to verify, difficult to implement consistently, and impossible to execute directly against patient data without manual translation.

CQL bridges that gap. It is a high-level, SQL-like language designed specifically for clinical use cases. A CQL expression can say “find patients with a documented HbA1c result above 9% in the past 12 months who do not have a follow-up appointment scheduled” in a form that is both readable by a clinician and executable by a runtime engine against FHIR Observation and Appointment resources.

In FHIR, CQL logic is packaged in the Library resource. A Measure resource references Library resources containing the CQL population criteria (initial population, denominator, numerator, exclusions). A PlanDefinition for clinical decision support references Library resources containing the CQL conditions that trigger recommendations.

CQL is the standard language for FHIR-based electronic Clinical Quality Measures (eCQMs) — the quality measures used in CMS reporting programs including MIPS, MSSP, and hospital quality programs.

Context and Usage

Where This Term Appears

  • eCQM specification: CMS and ONC publish quality measures as CQL logic packaged in FHIR Library and Measure resources
  • CDS Hooks services: External CDS services may use CQL internally to evaluate whether a hook event meets conditions for a card response
  • FHIR quality reporting: The QI-Core and DEQM IGs use CQL for measure logic
  • Clinical guideline authoring: The Clinical Guidelines IG (CPGL) uses CQL to express computable guideline recommendations

Common Usage Examples

In conversation: “The eCQM logic is in CQL — the denominator definition queries the FHIR Patient and Observation resources for patients 65+ with a qualifying diagnosis.”

In documentation: “The Library resource packages the CQL logic for numerator and denominator population criteria. The Measure resource references this Library by canonical URL.”

Relationship to Other Terms

  • FHIR — CQL expressions query FHIR resources; FHIR Library resources package CQL logic for distribution
  • CDS — CQL is one of the primary languages for encoding CDS logic in a computable, shareable form
  • CDS Hooks — CDS services that evaluate CQL can be invoked via CDS Hooks to surface guidance in EHR workflows
  • HL7 — the standards body that maintains the CQL specification

Common Misconceptions

Misconception: CQL Is a Programming Language

  • Incorrect belief: CQL is a programming language like Java or Python — it requires software engineers to write and maintain.
  • Reality: CQL is a domain-specific authoring language designed to be readable by clinical informaticists and quality measure developers, not just engineers. Its syntax is deliberately close to natural language and SQL to lower the barrier for clinical authors.
  • Why it matters: Quality measure authoring in CQL is a clinical informatics skill, not a software engineering one. The tools and workflows around CQL authoring are aimed at a different audience than general-purpose programming.

Misconception: CQL Only Applies to Quality Measures

  • Incorrect belief: CQL is a quality measurement tool — it has no role outside of eCQM reporting.
  • Reality: CQL is used across quality measurement (eCQMs), clinical decision support (CDS Hooks services, PlanDefinition), eligibility determination, and computable clinical guideline expression. Anywhere clinical logic needs to be evaluated against patient data, CQL can provide a standardized, shareable representation.
  • Why it matters: Teams building CDS tools, eligibility engines, or computable guidelines are CQL users even if they don’t work in quality reporting.

Why CQL Matters

Without CQL, clinical logic is locked in natural language documents or proprietary configurations that cannot be shared, validated against data, or executed consistently across systems. CQL provides a common language for clinical knowledge that can be authored once and executed anywhere a FHIR-capable runtime exists — enabling quality measures, CDS rules, and guideline recommendations to be shared as computable artifacts rather than PDF specifications.

Cross-References

  • FHIR — CQL expressions query FHIR resources; FHIR Library resources package CQL logic
  • CDS — CQL is one of the primary languages for encoding CDS logic in a computable form
  • CDS Hooks — CDS services that use CQL can be invoked via CDS Hooks
  • HL7 — the standards body that maintains the CQL specification

Last reviewed: January 29, 2026 Definition authority: HL7 International Content status: Canonical reference