« For Developers: Embedding, JS, APIs

Micrio versions

What are the Micrio versions out there, and which one should I use?

The latest client version of Micrio is 4.1.

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

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 4.1: https://b.micr.io/micrio-4.1.min.js

Browser versions and platforms

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

  • MS Edge 16+ (2017)
  • Firefox 52+ (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. Newer Micrio versions (3.0+) 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.

Non-changing data model

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

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 and 3, 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.

✉ Can't find what you're looking for? Contact us!