Micrio Knowledge Base

Appearance

Available Micrio client versions ​

TIP

The latest client version of Micrio is 5.0.

Micrio is always under development. New features can be added, and maintenance under the hood regularly happens.

Since the start in 2015, there have been 4 major Micrio versions. Of each, the latest stable versions are:

  • 1.9 (2016): The simple image zoomer, using Canvas2D for rendering
  • 2.9 (2019): 360° image support was added, using WebGL for rendering
  • 3.3 (2021): Full engine rewrite to use WebAssembly, and 100% WebGL (see our detailed blog post about it)
  • 4.1 (2022): Full rewrite to use TypeScript, and using a new rendering model
  • 5.0 (2024): Latest version, works with the newest dashboard (2024) and is backwards compatible with earlier versions

If you are working on a new project, it's always recommended to use the latest available Micrio version, to ensure performance and stability.

The current latest version is 5.0.

Browser versions and platforms ​

Micrio works on all modern browsers, on all platforms. The current latest Micrio version (5.0) runs 100% on:

  • MS Edge 16+ (2017)
  • Firefox 54+ (2017)
  • Chrome 57+ (2017)
  • Safari MacOS/iOS 11+ (2017)
  • Opera 44+ (2017)

Older Micrio versions (2.9 and older) even still work on Internet Explorer 10/11. Micrio versions 3.0 - 4.1 also have an automatic fallback to 2.9 in this case, which attempts to display the images using Micrio 2.9. However, your mileage may vary if you are using newer Micrio features which were not yet available in 2.9.

Static data model ​

It is important to note that Micrio aims to be fully backwards compatible. Its JSON data has been largely unchanged the same since 1.0, which means that you can use Micrio 5.0 for any previously created images and their markers, tours, etc.

Do note that since Micrio 5.0, there have been changes in the data model which makes images created in the latest dashboard (https://dash.micr.io/) incompatible with older viewer versions. So you cannot use Micrio 4 to view images created in the newest dashboard.

Please refer to the migration documentation for more info on what's changed.

Client API changes ​

The client behavior is not very different over all versions: there are markers, tours, positional audio, and user interface elements.

If you are using Micrio out of the box without any customizations on your end, it should be safe to upgrade older Micrio versions to the latest version.

If it ain't broke... ​

However, since each major version of Micrio has a stable final release, it is not required to update your project as soon as there is a new Micrio version.

Many released projects still run on Micrio versions 1, 2, 3, and 4, and they still work perfectly. Currently there are no known issues with any of these versions; they work on all platforms.

Updating custom projects to a newer Micrio versions ​

In case you have a Micrio implementation which uses the Micrio client APIs, please refer to our (upcoming) migration guides to highlight the differences between major Micrio versions.