Clinical Practice Guidelines
2.0.0-draft - draft International flag

Clinical Practice Guidelines, published by HL7 International / Clinical Decision Support. This guide is not an authorized publication; it is the continuous build for version 2.0.0-draft built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of and changes regularly. See the Directory of published versions

CPG Home

Official URL: Version: 2.0.0-draft
Active as of 2024-06-06 Computable Name: CPG

The FHIR Clinical Guidelines Implementation Guide (CPG IG) provides a means of creating a computable representation of a narrative clinical guideline that is faithful to guideline intent and supports the derivation of downstream capabilities such as cognitive and decision support, quality measures, case reporting, and documentation templates that direct clinical documentation in support of determining guideline compliance.

Where possible, new and updated content will be highlighted with green text and background.

This ballot of the Clinical Guidelines implementation guides incorporates feedback that has been received during the trial-use implementation period. Feedback from production implementations of clinical reasoning capability as well as multiple content development projects covering various aspects of computable guideline content development and implementation has been included.

Major changes include:

  • Removed Shareable/Publishable/Executable profiles and referenced the CRMI IG for those capabilities instead (see Profiles)
  • Removed the Using CQL and Libraries conformance requirements and referenced the Using CQL with FHIR IG for those capabilities instead (see Libraries)
  • Detailed descriptions of activity flow (see Activity Flow)
  • Recommend an Immunization activity now uses MedicationRequest
  • Added L1 checklist from GIN-NA working group (see L1 Checklist)
  • Moved most example IGs to cqframework (see Examples)

The following sections detail the changes that were applied for this ballot.

The following trackers were applied for this version:

Status: Summary:(Jira Issue)

  • Applied: Add extensions to identify the packaging and testing tooling for an artifact(FHIR-25741)
  • Applied: Better definitions for each activity(FHIR-38743)
  • Applied: Add support for specifying CQL options in CQL/ELM libraries and projects(FHIR-32672)
  • Applied: Add a CPG Packaging Like the Measure Packaging Operation(FHIR-35796)
  • Applied: Ability to specify supported CQL versions(FHIR-32676)
  • Applied: Add guidance on when available ELM can be used(FHIR-40486)
  • Applied: Add description of types of artifacts(FHIR-26607)
  • Applied: Unable to file issues against 1.0 version in HL7 JIRA(FHIR-40964)
  • Applied: Add more detailed description of activity flow(FHIR-43074)
  • Applied: ImmunizationRecommendation example does not point at meta.profile(FHIR-34350)
  • Applied: Change Immunization action(FHIR-40298)
  • Applied: Refactor to use CRMI profiles(FHIR-42973)

In addition, the implementation guide source was completely updated to run on the latest IG publication tooling, which included numerous typographical and technical corrections throughout.

Known Issues:

The doNotPerform extension was approved to be allowed on Task, however, that context change was missed in the application, the following TC is to address this issue:

  • FHIR-43369: Fix context of request-doNotPerform extension (see FHIR-30207 for original resolution)

This implementation guide is organized into the following sections, accessible via the menu bar at the top of every page:

  • Home: The home page provides summary, introductory, and background information
  • Approach: The approach page documents the overall approach to representing computable guideline content
  • Methodology: Describes methodologies for developing computable guideline content
  • Profiles: Describes expectations for use and an index of the profiles and extensions used in representing computable guideline content
  • Terminology: Describes expectations for the use of terminology as part of computable guideline content
  • Libraries: Describes expectations for the use of libraries of computable expressions (e.g. CQL) as part of computable guideline content
  • Examples: Index of examples and example artifacts
  • Downloads: Downloads for the specification
  • Glossary: Glossary of key terms used in the specification
  • Version History: Index of all versions of this implementation guide


This implementation guide supports the development of standards-based computable representations of the content of clinical care guidelines. Its content pertains to technical aspects of digital guidelines implementation and is intended to be usable across multiple use cases across clinical domains as well as in the International Realm.

This implementation guide has been developed through a multi-stakeholder effort, holistically involving a range of stakeholders, including those who work at the beginning of the process (e.g., guideline developers) to the end users (e.g., clinical implementation team representatives, health IT developers, patients/patient advocates), and others in between (e.g., informaticists, communicators, evaluators, public health organizations, clinical quality measure and clinical decision support developers).

The premise involves determining the representation of clinical practice guideline recommendations in FHIR as part of an iterative guideline development and implementation process (Figure 1.1). By including all the relevant perspectives (e.g., guideline authors, informaticists, implementers, communicators, evaluators) as part of the iterative process, the resulting computable representation of the recommendations should be well-vetted and more readily implemented across multiple clinical domains.

Guideline development cycle

Figure 1.1 Iterative Guideline Development and Implementation Process (Willet, D., University of Texas Southwestern, 2018)


Clinical quality lifecycle

Figure 1.2 Clinical Quality Lifecycle with situated standards to address each respective phase. The CPG-IG addresses a critical gap in explicitly formalizing the guideline recommendations and other guideline features as computer-interpretable for downstream consumption and closing the feedback and feedforward loop(s).

Translating guideline recommendations and other types of guidance into practice has historically been a site by site exercise that has been disconnected from guideline/guidance development, creating unnecessary redundancies and introducing potential errors in translation that can lead to inconsistencies in how the guideline or guidance is executed. This clinical practice guidelines implementation guide (CPG-IG) consists of standards and a standardized, scalable approach to help make the effort of translating and implementing clinical practice guidelines and other types of guidance more efficient and effective. Key aspects include:

  1. An integrated guideline/guidance development and implementation process (referred to as “the integrated process”)
  2. Common standards that can work across the entire data lifecycle (a.k.a. learning health system - see Figure 1.2) and different electronic health record (EHR) platforms
  3. Closed-loop guideline content and information flow inclusive of feedback and feedforward processes

This implementation guide is focused on the development of computable representations of Clinical Guideline content as FHIR knowledge artifacts. Since the initial publication, much of the guidance around the content management lifecycle (Shareable, Publishable, Computable, and Executable profile categories) has been generalized to apply across similar content management use cases in other FHIR IGs and is now available in the Canonical Resource Management Infrastructure. Content conforming to this implementation guide should make use of the content development approach supported by that implementation guide.

In addition, the initial publication of this IG included conformance and guidance related to the use of CQL. This material has been generalized to apply across similar use cases in other FHIR IGs and is now available in the Using CQL With FHIR implementation guide. Content conforming to this implementation guide should make use of the CQL approach supported by that implementation guide.


The purpose of the CPG-IG is to:

  • Enable computable guideline specification to occur concurrently with guideline development;
  • Faithfully express guideline intent, including rationale and linkage to evidence-base;
  • Enable efficient and effective use and reuse of the guideline specification in downstream capabilities;
  • Accelerate the development of computable guideline specifications and interventions through an integrated, cross-functional, rapid-cycle (Agile) development process that is inclusive of local implementation;
  • More closely tie guideline intent, interventions, and measurements; and
  • Provide closed-loop (feedback and feedforward loops) across the knowledge, practice, and discovery or evidence ecosystems.

Direct goals:

  • Reduce duplicate development effort involved in the implementation of clinical practice guideline recommendations in clinical systems
  • Reduce unnecessary and/or unintentional variability in clinical practice guideline implementation
  • Improve efficiency and effectiveness of guideline dissemination and implementation processes (e.g. decrease time to uptake of clinical best practices)
  • Measure compliance with clinical practice guideline recommendations
  • Improve appropriate compliance with clinical practice guideline recommendations
  • Afford means for full lifecycle feedback loop in best practice development process (e.g. Professional Guideline Development, Learning Health System, Clinical Translational and Implementation Sciences) including basic considerations for discovery to delivery.
  • [NOTE: EBM IG focused on up front processes; Public Health and QI on reporting results, and Registries on data collection and input into EBM/research activities. Suggest explicit collaboration with these groups.]

Indirect goals:

  • Minimize the time needed to implement clinical practice guideline recommendations in clinical systems
  • Improve the ability to share computable biomedical knowledge artifacts (clinical knowledge definitions, value sets, order sets, expression logic, interventions, etc.)
  • Enhance the value of computable guidelines (decrease cost/effort, increase utility/usability)

The primary objective of the CPG approach to codifying clinical practice guidelines is to accelerate the translation and delivery of expert body evidence-based and best practice recommendations to the point of care. The CPG-IG was developed through multi-stakeholder engagement (e.g., guideline developers, knowledge engineers, clinical implementers, standards experts, patient and caregiver advocates, governmental and nongovernmental agencies, and others) to evolve the development approach and means of expressing clinical practice guidelines in computable formats. These stakeholders identified the need to concurrently develop computable formats along with the narrative guidelines/guidance. As such, the knowledge engineering process, inclusive of elicitation, translation, specification, and formal representation, must be integrated with the guideline development process and serve the function of translating between the clinical domain and the formal, computable expressions thereof. It is the intent of this section to describe some of the fundamentals of these activities as well as the concept, means, and performances to carry out this activity.

Secondarily, we describe how these activities interact with adjacent and related activities as well as content and related standards in the broader knowledge ecosystem (inclusive of evidence ecosystem, guideline developers, guideline-directed care, quality measure ecosystem, registry community, etc.). This includes upstream activities, such as evidence generation and knowledge discovery, and downstream activities, such decision support (i.e., CDS), patient care, advanced cognitive support (e.g., using SMART-on-FHIR apps), quality measurement and reporting, and electronic case reporting (for similarly scoped conditions). All can serve to inform subsequent iterations of clinical guidelines and guideline-directed care and thus have a key role in the learning health system.


This implementation guide provides both an approach and suggested methodology for computable representation of clinical practice guidelines, so the audience for this guide is broad and inclusive of an array of roles across the spectrum of clinical guideline development and implementation, from clinical guideline developers and authors, through clinical informaticists, health system integrators and clinical systems developers. Areas of the implementation guide that are more technical assume familiarity with relevant standards, including FHIR and Clinical Quality Language (CQL), though links are provided to reference materials for further reading.

Notes to Target Audiences:

The CPG Approach section highlights:

  • Various highly specialized and technical participants in the “Knowledge-to-Delivery-to-Discovery” ecosystem that often interact with each other’s work products but may not interact directly with each other;
  • How the HL7 CPG-IG recognizes their distinct and valuable work and provides numerous opportunities to reuse domain standards (e.g., FHIR and other HL7 IG’s); and
  • A reconceptualization of work processes that share and reuse essential information and content.

Much of this work has been informed by several international efforts, including the U.S. Centers for Disease Control and Prevention’s (CDC’s) Adapting Clinical Guidelines for the Digital Age initiative (ref), the World Health Organization’s (WHO’s) Antenatal Care Guidelines (ref), the HL7 Clinical Decision Support and Clinical Quality Information Working Groups, and numerous other publicly funded and private sector initiatives, including local health system implementations of guidelines and in-workflow pathways.

To the Guideline Developer: Working in parallel with knowledge engineers and other downstream consumers (e.g., local implementers) can identify areas within the guideline that need clarification, helping improve the narrative, provide opportunity to review the translation of the tools for fidelity to the guideline, and get early feedback from end-consumers of the guideline work product – all before the guidelines or tools are published.

To the Knowledge Engineer: Working in parallel with guideline developers allows validation of translations directly with the “source of truth,” helping ensure accuracy. Working in parallel with downstream consumers (e.g., local implementers) provides the ability to confirm feasibility and validity for the users of the artifacts as they are produced by knowledge engineers and may even provide a useful means to build and validate once (i.e., without unnecessary redundancy) against real-world data and implementations.

To the Downstream Consumers: Being involved with the guideline development and knowledge engineering can help identify issues early in the process and optimize incorporation of the knowledge into downstream products that aid in implementation, such as apps, measures, or other point-of-care tools, and significantly reduce the rework of re-engineering parts of the guideline, saving time and effort.

To the Local Implementer: The main goal of the knowledge developed is to implement it in practice. Having local implementers (both clinicians and informaticians) involved with guideline development and knowledge engineering allows for the ability to communicate anticipated issues for implementation so that guideline developers or knowledge engineers have the opportunity to adjust their respective products in order to help optimize the ease and positive impact of implementation. A computable guideline representation can significantly reduce rework, saving time and effort for local implementations.

To the Evidence Ecosystem: Taking a holistic approach to guideline development and implementation includes considerations for learning and continuous improvement through feedback and feedforward loops. A number of activities in the knowledge ecosystem that serve specific functions (e.g., case reporting to public health, quality reporting to payers, quality/data reporting to medical society registries, etc.) could also help provide the evidence that can inform updates to the guidelines/guidance. This evidence may be based on patient-level, point-of-care guideline usage, and detailed tracking thereof, affording new means of collecting evidence.

Using approaches, standards, and techniques addressed in further detail in individual sections, the CPG-on-FHIR as described in this implementation guide can serve a critical role in the full data lifecycle of a Learning Health System.


The need for computable care guidelines can be considered in the context of the data lifecycle, where the representation of the guideline recommendations in FHIR helps deliver actionable knowledge (Figure 1.2).

Delivering actionable knowledge

Figure 1.3 The data lifecycle and impacts to the public’s health (Michaels, M, U.S. Centers for Disease Control and Prevention, 2019).

By translating the recommendations in clinical practice guidelines at the source, and disseminating a computable version along with the narrative version of the guidelines, the effort of translation would not be repeated across every organization that intends to apply the recommendations. Likewise, unnecessary or unintentional variations as a result of duplicative translation efforts could be prevented with a standard, computable version that is ready to be implemented. In removing the need for translating recommendations at each local clinical system, and removing as much variation as possible through a standard translation, the time needed to apply the recommendations in practice should also be reduced, helping scientific evidence reach patient care more easily, quickly, accurately, and consistently.

In considering common patterns across multiple guidelines, this implementation guide can apply to a variety of use cases across multiple clinical domains, as is evidenced by the examples provided. These common patterns not only create a way to organize the content for the translation into computable recommendations but also help implementers operationalize the recommendations within clinical workflows.


Figure 1.4 Redesigning guideline development and implementation: The Integrated Process (Michaels, M, U.S. Centers for Disease Control and Prevention, 2019). NOTE: The “Implementation” perspective represents local implementers that incorporate the local considerations into guideline translations, and “Local Implementations” represent the actual implementation at clinical sites.

In particular, the translation into tools like CDS and eCQMs applies common health IT standards like Fast Healthcare Interoperability Resources (FHIR) and Clinical Quality Language (CQL). How to use these standards to develop shareable, platform-independent tools based on guidelines/guidance for a variety of diseases, conditions, or preventive care is the primary focus of this CPG-IG, including this Approach section. Secondarily, this CPG-IG shows how using FHIR can help with other data-focused activities, such as public health reporting (i.e., using electronic case reports) or quality reporting (i.e., using eCQMs), that provide a feedback loop that feeds the evidence. The evidence can also be represented using FHIR (i.e., EBM-on-FHIR) and could be applied in summarizing evidence and updating guidelines/guidance. This completes the “data lifecycle” that allows for continuous learning and improvement – a “learning health system”. The CPG-IG approach can be a key component of a learning health system in times requiring rapid response, where knowledge of best practice is not well-known.

It is important to note that this effort is a concerted attempt to build on, learn from, contribute to, and work with existing approaches, initiatives, and efforts in guideline development, translation, and implementation. The contribution of this implementation guide is focused on describing a best-practices conceptual approach combined with a practical methodology that leverages the interoperability framework provided by FHIR as a way to overcome the impedance mismatch between knowledge and clinical data models that is commonly encountered by efforts in this space. The approach and methodologies presented here are the combined result of many person years of work across multiple initiatives and coordinated with groups like Health eDecisions, Clinical Quality Framework initiative, the CDC’s Adapting Clinical Guidelines for the Digital Age intiative, the Object Management Group’s BPM+ for Health initiative, IHE’s Computable Care Guidelines initiative, and the WHO’s Smart Guidelines initiative. Feedback on the approach and methodologies are welcomed and encouraged. See the references section for further reading and background that informs the approach taken here.


  • A multi-layered framework for disseminating knowledge for computer-based decision support. Journal of the American Medical Informatics Association 2011 Dec; 18(Suppl 1): i132-i139.
  • An Ontological Framework for Adaptive Medical Workflow. Journal of Biomedical Informatics Volume 41, Issue 5, October 2008, Pages 829-836.
  • International Standard Classification of Occupations (ISCO).
  • Classifying health workers: Mapping occupations to the international standard classification. World Health Organization.
  • Comparing Computer-interpretable Guideline Models: A Case-study Approach. Journal of the American Medical Informatics Association Volume 10, Issue 1, January 2003, Pages 52–68, Mor Peleg, PhD, Samson Tu, MS, Jonathan Bury, MBChB, Paolo Ciccarese, MSc, John Fox, PhD, Robert A. Greenes, MD, PhD, Richard Hall, MSc, Peter D. Johnson, MBBS, Neill Jones, MBBS, Anand Kumar, MBBS, Silvia Miksch, PhD, Silvana Quaglini, PhD, Andreas Seyfang, MSc, Edward H. Shortliffe, MD, PhD, Mario Stefanelli, PhD.
  • Computer-interpretable clinical guidelines: A methodological review. Journal of Biomedical Informatics Volume 46, Issue 4, August 2013, Pages 744-763. Mor Peleg.
  • Computerization of workflows, guidelines, and care pathways: a review of implementation challenges for process-oriented health information systems. Journal of the American Medical Informatics Association, Volume 18, Issue 6, November 2011, Pages 738–748. Phil Gooch, Abdul Roudsari.
  • Conceptual alignment of electronic health record data with guideline and workflow knowledge. International Journal of Medical Informatics 64 (2001) 259–274. Gunther Schaeow, Daniel C. Russler, Clement J. McDonald.
  • GEM: A Proposal for a More Comprehensive Guideline Document Model Using XML. Journal of the American Medical Informatics Association, Volume 7, Issue 5, September 2000, Pages 488–498, Richard N. Shiffman, MD, MCIS, Bryant T. Karras, MD, Abha Agrawal, MD, Roland Chen, MD, Luis Marenco, MD, Sujai Nath, MD.
  • GLIF3: a representation format for sharable computer-interpretable clinical practice guidelines. Journal of Biomedical Informatics Volume 37, Issue 3, June 2004, Pages 147-161. Aziz A Boxwala, Mor Peleg, Samson Tu, Omolola Ogunyemi, Qing T Zeng, Dongwen Wang, Vimla L Patel, Robert A Greenes, Edward H Shortliffe.
  • Modelling biological processes using workflow and Petri Net models. Bioinformatics, Volume 18, Issue 6, June 2002, Pages 825–837, Mor Peleg, Iwei Yeh, Russ B. Altman.
  • Operationalizing Guideline-based Care. Presentation at the 2013 AeHIN General Meeting. Derek Ritz.
  • Representation primitives, process models and patient data in computer-interpretable clinical practice guidelines: A literature review of guideline representation models. Dongwen Wang, Mor Peleg, Samson W Tu, Aziz A Boxwala, Robert A Greenes, Vimla L Patel, Edward H Shortliffe. International Journal of Medical Informatics, Volume 68, Issues 1–3, 2002, Pages 59-70, ISSN 1386-5056,


Author Name Affiliation Role
Sivaram Arabandi, MD, MS Ontopro LLC Contributor
J. Rex Astles, PhD, FAACC CDC, Health Scientist Contributor
Wendy Blumenthal, MPH CDC, Health Scientist Contributor
Mike Boston UX Architect Contributor
Matthew M. Burton, MD Apervita, Inc., VP Clinical Informatics Editor
Zahid Butt MD, FACG Medisolv Inc, CEO Contributor
Dave Carlson, PhD Clinical Cloud Solutions, Solution Architect Contributor
Daryl Chertcoff HLN Consulting, Solution Architect Contributor
Jeffrey Danford, MS Allscripts, Sr Principal Software Engineer Contributor
Floyd Eisenberg, MD, MPH iParsimony Contributor, Co-Chair (Clinical Quality Information)
Margaret S. Filios, MSc, BSN, RN, CAPT USPHS CDC, Senior Scientist Contributor
Daniel Futerman Jembi Health Systems, Senior Program Manager Contributor
Joel C. Harder, MBA AiCPG, Executive Director Contributor
Aaron M. Harris, MD, MPH, FACP CDC, Subject Matter Expert Contributor
Dwayne Hoelscher, DNP, RN-BC, CPHIMS Nursing Informaticist Contributor
Emma Jones RN-BC, MSN Allscripts, Expert Business Analyst Contributor, Co-Chair (Patient Care), IHE Co-Chair (Patient Care Coordination)
Brian Kaney Vermonster Editor
James Kariuki CDC, Health Scientist Contributor
Kensaku Kawamoto, MD, PhD, MHS   Contributor, Co-Chair (Clinical Decision Support)
Robert Lario, MSE, MBA University of Utah/US Department of Veterans Affairs, Health Standards Architect Contributor
Taylor Le Vermonster Editor
Ira M. Lubin, PhD CDC, Health Scientist Contributor
Laura Haak Marcial RTI International, Health Informaticist Contributor
Robert McClure, MD, MPH   Contributor, Co-Chair (Vocabulary)
Maria Michaels CDC Editor
Blackford Middleton, MD, MPH, MSc, FACP, FACMI, FHIMSS, FIAHSI Apervita, Chief Informatics & Innovation Officer Contributor
Nikhil Patel MBBS, BSc NHS, Physician Contributor
Bryn Rhodes Dynamic Content Group Editor, Co-Chair (Clinical Decision Support)
Derek Ritz ecGroup Inc., Principal Consultant Contributor, IHE Co-Chair (Quality Reporting and Public Health)
Susan J. Robinson, PhD CDC, Senior Advisor Contributor
Julie Scherer, PhD Motive Medical Intelligence, Chief Informatics Officer Contributor
Julia Skapik Cognitive Medical Systems, CHIO Contributor
Larie Smoyer, MD Motive Medical Intelligence, VP of Product Development Contributor
Davide Sottara, PhD Mayo Clinic Contributor
Keith Toussaint KMT Strategies, Principal Contributor
Jodi Wachs MD, FAAPM&R FAMIA Clinical Informaticist Contributor
David Winters The MITRE Corporation Contributor

Cross Version Analysis

This is an R4 IG. None of the features it uses are changed in R4B, so it can be used as is with R4B systems. Packages for both R4 (hl7.fhir.uv.cpg.r4) and R4B (hl7.fhir.uv.cpg.r4b) are available.

Dependency Table

Package hl7.fhir.uv.extensions.r4#1.0.0

This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Sun, Mar 26, 2023 08:46+1100+11:00)

Package hl7.fhir.uv.extensions#5.1.0

This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Sat, Apr 27, 2024 18:39+1000+10:00)

Globals Table

There are no Global profiles defined

IP Statements

This publication includes IP covered under the following statements.