Skip to main content
Skip table of contents

Release Notes

Important Note

Version 3.0 of the Viewer plugin requires XNAT 1.8 in order to run correctly. See XNAT OHIF Plugin Compatibility Matrix


v3.6.0 requires XNAT 1.8.7 or later. It will not install or run on earlier versions of XNAT.

Version 3.6 of the viewer brings new exciting features such as organising and displaying multi-stack images into individual stacks, a dedicated viewport menu to control display options, and image fusion in the 2D viewing mode. Various improvements and bug fixes have also been introduced.

New Features

  • Organise and display multi-stack frames into subgroups. Only MR scans are currently supported.
  • Viewport options menu to declutter the display and reduce visual search and selection time.
  • Support 2D image fusion using cornerstone layers.
  • Toggle visibility of annotations (masks, contours & measurements) for individual viewports.


  • Notify the user of metadata inconsistencies found in individual images.
  • Added the capability to use false color images instead of colormaps in 2D image fusion.
  • Make the dialog display optional for new measurements.
  • Display fusion description and colormap name on the viewport.


  • Remove the polyfill support for IE 11 browser.
  • Fixed line intersection checks for the reference lines tool.


  • Fixed a bug that breaks the app when rendering overlay data over thumbnail images.


  • Fixed issue 44: Ensure ROICollections return a non-null, non-empty string to use as a filename.



  • Added Viewer Config API (/viewerConfig). Currently, serves endpoints only to GET and PUT ROI Presets.
  • Select ROI labels using a list populated from presets stored on XNAT at project-level.
  • Display overlays in the scan thumbnail view for scans with overlay data.
  • Deactivated the export of ROI Collections in cases of unsupported modalities or insufficient permission.
  • Improved alert messages to clarify that viewer will automatically open, surface errors to user if metadata cannot be generated.
  • Added scrollbar to the scan browser.


  • Fixed a bug in obtaining XNAT user details for guest access.
  • Fixed a bug preventing guests from loading the viewer.
  • Fixed bug blocking json generation from subject page "View Images" link.


v3.5.0 requires XNAT 1.8.7 or later. It will not install or run on earlier versions of XNAT.

Version 3.5 of the viewer features performance improvements to the session metadata creation, serialisation and retrieval. The 3D MPR mode now supports rendering and viewing of contour ROIs, via the creation of surfaces that can be cut through in arbitrary planes. Other features, improvements and bug fixes have also been implemented.

New Features

  • Improved session JSON creation, serialisation and retrieval processes:
    • JSON metadata minification with up to 50% size reduction.
    • Optimised CPU and memory utilisation.
  • ROI contour rendering in the 3D MPR mode.
  • Volume calculation and display for contour and mask ROIs.
  • Calculation and display of 2D statistics of mask ROIs to make the behaviour more consistent with that for contour ROIs.


  • Populate DICOM Equipment module values from the reference scan for storing ROI Collections.
  • Display scan modality in the scan browser.
  • Upgraded underlying JavaScript packages and tools.


  • Fixed measurement import/export issue for multiframe images.
  • Fixed issues caused when using Node.js v16.14.0.
  • Restrict NM image fusion to be enabled only for image type 'RECON TOMO'.



  • Fixed import and export issues of measurement data for DICOM multiframe images.
  • Set values of the DICOM General Equipment tags based on the viewer attributes: manufacturer, model-name and software-versions.


Two major new features have been introduced in this XNAT OHIF Viewer 3.4.0 release. A Measurement Service to manage and interact with measurement annotations via a dedicated panel, as well as the ability to exchange measurement collections data with XNAT. The integration of MONAI Label as a new menu within the Masks panel which offers interactive image annotation and segmentation.  

New Features

  • A new Measurement Service to manage and interact with measurement annotations, offering:
    • Measurement panel to group measurements into working and imported collections.
    • Export and import menus to exchange measurement collections with the XNAT archive.
    • Individual measurement interaction buttons: edit metadata, toggle visibility, jump to slice, and remove.
    • Measurement API to interface with measurements from other Viewer extensions.
    • Support to set and restore presentation state for individual measurements.
  • An integration client for MONAI Label to facilitate interactive medical image annotation using both interactive and automated annotation models.
  • Ability to switch between NVIDIA AIAA or MONAILabel tools based on the backend configuration.


  • New settings option to load a scan from the middle rather than from the top slice.
  • Added a progress indicator to monitor the loading progress of images. Currently, does not support multiframe images or images that were removed from cache.


  • Fixed issues caused when switching between the 3D MPR and the standard viewer modes.
  • Other minor tweaks and bug fixes.


Version 3.3.0 of the XNAT OHIF Viewer focuses on optimizing the data import process of the Contour-based ROIs. The lazy loading feature allows for quicker and more efficient navigation of contour ROIs, where only required ROIs can be loaded interactively. The concurrent loading of contour ROIs employs web workers to extract the RTStruct polygon data with speed optimization of 65%. The display colors of contour ROIs can now be switched between three different schemes (project template, from metadata, or custom values), where the project color template can be added/edited via the OHIF Viewer ROI Color API.

The mask drawing tools were refactored to enable better interaction with touch screen devices.

New Features

  • Lazy loading of contour ROIs. Feature is inactive by default but can be enabled via Preferences.
  • Concurrent loading of contour ROIs using web workers.
  • Server-side storage of ROI color template at project-level. Please refer to the OHIF Viewer ROI Color API in the XNAT Swagger page.

  • Switch between contour ROI color schemes - project template, from metadata, or custom values.


  • Supported drawing/import/export of mask ROIs for the Ultrasound Image Storage 1.2.840.10008.
  • Refactored segmentation and mask tools for touch-based interaction.
  • Added UI controls to sort the contour ROI list by name. Applies only to the locked collections.
  • Used automatically generated notation to identify scans with duplicate series number.
  • Switched to SVGR loader to enable custom title for icons.
  • Removed unnecessary ITK modules to reduce the bundle size.


  • Rebuild JSON metadata on certain events if project anonymization enabled and add support for a subject-level event.
  • Fixed contour ROI import/export for multiframe images.
  • Fixed the rendering position of the contour sculpt tool.
  • Other minor tweaks and bug fixes.


The XNAT OHIF Viewer v3.2.0 introduces new features such as 3D image fusion, and viewer links in the XNAT search listings.

New Features

  • Multi-volume image fusion in 3D MPR mode.
  • Two new tools: reference lines and crosshairs.
  • Importing ROI collections via clicking on relevant icons in the study browser.
  • Link to open viewer from XNAT search listings with admin configuration for default project listings.


  • Improved support for DICOM Nuclear Medicine (NM) IOD.
  • Orientation marker in the 3D MPR mode.
  • Keyboard shortcuts for mask undo/redo.
  • Refactored the mask settings menu for improved interaction.
  • Upgraded the image loader to use WebAssembly for data decoding.
  • Display subject’s ID/name in the Viewer’s browser tab.
  • Cache ROI collection numbers displayed in the Scan Browser to reduce repeated API calls.
  • Display windowing information in the viewport overlay.


  • Prevent regenerating session JSON on project sharing events.
  • Fixed mask import for coplanar and perpendicular segmentation data.
  • Fixed duplicate StudyInstanceUID issue.
  • Upgraded dependencies to recent applicable versions.
  • Fixed missing person and user details in AIM metadata.
  • Fixed image thumbnail re-rendering issue.
  • Fixed intensity scaling for images with variable window/level values.
  • Refactored smooth and sync components to maintain state during switching between scans.


Version 3.1.0 of the XNAT OHIF Viewer brings new features such as the DICOM Tag Browser, segmentation tools (correction scissors & undo/redo), and warning notifications about inconsistencies in scan data. The Scan Browser panel has been refactored to highlight the active scan and show the number of ROI collections available per scan.

The integrated NVIDIA AIAA Client now supports the 3D Deepgrow model, and accurately aligns annotation data received from the AIAA server. 

New & Improved

  • Upgraded to the viewer package v4.9.20 of the mainstream OHIF Viewer (@ohif/viewer@4.9.20).
  • Filter ROI collection import list based on session label and scan number.
  • DICOM Tag Browser added, based on a refactored extension from OHIF Viewer. The full list of elements are only displayed for loaded images.
  • Visual notifications added to warn about inconsistencies in scan data, e.g. frames have different dimensions.
  • Highlight active scan in the Scan Browser panel, and show the number of available ROIs per scan.
  • Added new segmentation tools: correction scissors and brush eraser.
  • Toolbar buttons added to undo/redo manual segmentation.
  • Support changing segmentation brush size when using touch screen devices.
  • Smart & Auto segmentation brush: custom gate-separation value + retain the settings between viewer sessions.
  • Show the number of slices for each segment and jump to the middle slice when value clicked.
  • Toggle visibility of contour collections.
  • Added support for 3D Deepgrow in the NVIDIA AIAA Client (requires Clara v4.0+).


  • Display label for non-ROI-collection assessors in the assessment table (Issue #28).
  • Refactored a new class to read and align NIfTI segmentation data. Added support for cornerstonejs/nifti-image-loader.
  • Fixed buffer size for reading NIfTI segmentation data.
  • Fixed DICOM overlays not displaying issue. 
  • Handle errors when loading images and show notification with error message (Issue #22).
  • Notify about ROI export issues.
  • Added a progress indicator for importing contour collections.
  • Fixed a bug that prevented changing Window/Level preferences.
  • Fixed slice order in image sets.
  • Fixed the annotations ‘delete all’ function to remove currently displayed measurements.
  • Fixed segmentation export issue when having multiple viewports.
  • Fixed Ultrasound measurements to show values in physical units. Fix does not support SequenceOfUltrasoundRegions with a multiple entries.
  • Fixed imageId issue that prevented scrolling through some multi-frame images.



  • Fixed JSON metadata not being updated when new data is added to existing session. This was causing viewer to only display part of the session.
  • Fixed scan date issue.
  • Added milliseconds to the ROI assessor labels.


Version 3.0.0 of the XNAT OHIF Viewer focuses on defining regions-of-interest, with the "ROI Collection" datatype now a part of core XNAT, which removes the dependency on having a separate datatype plugin. There are new mask creation tools and an integration of NVIDIA Clara's AI-Assisted Annotation, which seamlessly applies machine-learning models to auto-segment ROIs that are both editable within the viewer and directly save-able within XNAT. There is support for DICOM "fractional segmentations", allowing the representation of volumetric masks that are probabilistic (e.g., allowing the representation of the degree of certainty of machine learning models). ROI creation on 2-D image modalities is also now available. There are additional enhancements to support for contour datatypes

We track core upgrades to the architecture of the main OHIF project, in particular the transition to a more modern React JavaScript framework to improve viewer performance in XNAT and allow the inclusion of major new functionality, such as a 3D-MPR mode for the first time. 

New & Improved


  • Fix event-triggered JSON metadata generation for session uploads.
  • JSON metadata format update to support OHIF 4.2.7 requirements.
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.