Embedded Classification Tools (ECT)


What’s new in version 1.8

Version 1.8 introduces several important enhancements, including new runtime functions and expanded customization options for multiple ECT instances.

New functions

You can now dynamically change, at runtime, the Source, Minor Version, or Language of any Embedded Coding Tool or Embedded Browser instance.
These new functions allow applications to react to user preferences or context without reloading the page.

  • Change Source: updates the classification source used by an ECT instance (e.g., MMS or ICF).
  • Change Minor Version: switches the current minor version used by an instance (e.g., 2026-01 or a previous release).
  • Change Language: changes the language of an ECT instance.

For details, refer to the documentation of the Embedded Coding Tool and the Embedded Browser.

Improved customization for multiple instances

Version 1.8 significantly expands the ability to customize each Embedded Classification Tools instance independently.
This allows running multiple ECT instances on the same page: each connected to different API server, using different ICD classifications, or targeting different minor versions.
You now have full flexibility to configure each instance according to your needs.

The following settings can now be configured independently for each ECT instance:

  • apiServerUrl: allows each Embedded Coding Tool or Browser instance to use a different ICD-API server endpoint.
  • apiSecured: enables or disables secure API access independently for each instance.
  • source: defines the classification used by the instance.
  • minorVersion: sets the minor version used by the instance.

For details, refer to the documentation of the Multiple instances of Embedded Classification Tools components .


Upgrading to version 1.8 is fully safe. There are no breaking changes when moving from any previous 1.x release to this version.

We strongly recommend updating your current ECT installation to version 1.8.


Overview

ICD-11 Coding Tool and ICD-11 Browser are web‑based applications that help users search, explore, and navigate ICD‑11 categories.

The Embedded Classification Tools (ECT) make it possible to integrate the full ICD‑11 Coding Tool and/or ICD‑11 Browser directly into any web application.

ECT structure

structure of the ECT library

ECT is written in JavaScript to ensure full compatibility with modern web environments and to provide an easy way to embed ICD‑11 functionality into your own systems.

Under the hood, ECT is powered by the ICD-API, which delivers all classification content and search capabilities.

Integrating the Embedded Classification Tools is straightforward: simply include the provided JavaScript and CSS files and apply a few small adjustments to your web page


Installation

The Embedded Classification Tools (ECT) can be manually loaded from our CDN or installed via npm.

CDN

Include the stylesheet file icd11ect-1.8.css in the <head> section of your page. 

<head>
    <link rel="stylesheet" href="https://icdcdn.who.int/embeddedct/icd11ect-1.8.css">
</head>

Include the JavaScript file icd11ect-1.8.js before the closing </body> tag. 

<script src="https://icdcdn.who.int/embeddedct/icd11ect-1.8.js"></script>

Try out the code playgrounds on the ECT samples page.

npm

Install the module via npm:

npm install @whoicd/icd11ect

After the installation, import the package and the stylesheet file:

import * as ECT from '@whoicd/icd11ect';
import '@whoicd/icd11ect/style.css';

Try out the code playgrounds on how to integrate ECT in Angular, React and Vue.js.


Documentation

The documentation offers a few ways to learn about the Embedded Classification Tools (ECT) library: