Using ImageJ and Fiji with OMERO

This covers all OMERO versions from 5.1.0 and newer and assumes you have never installed ImageJ or Fiji before.

You can tell what version your OMERO is from the fine print at the bottom of the login screen.


In order to connect to an OMERO server and use the data stored there directly in ImageJ and Fiji, plugins have to be installed. The following instructions guide you through the download, installation and use of ImageJ, Fiji and the plugins.


The OMERO.insight-ij plugin requires Java 1.7 or later to function.

Downloading and installing ImageJ

  1. Download the latest version of ImageJ for your platform from the website:


  2. On Windows run the set-up programme (either from the Downloads folder or when prompted by the download Wizard) and follow instructions to install ImageJ.

    On Mac OS X, extract the .zip archive and drag the ImageJ folder to your Applications folder.

    On Linux extract the .gz archive and double click the “run” script.

    Further installation instructions can be found on the ImageJ web site (URL above).

Downloading and Installing Fiji

Fiji (Fiji is Just ImageJ) is a distribution of ImageJ together with Java, Java3D and a lot of plugins organized into a coherent menu structure.

  1. Download the latest version of Fiji for your platform from the website:


  2. The Fiji downloads page includes installation instructions.

    On Windows it is recommended you install the Fiji executable within your user space for example: C:\Users\[your name]\, not in the normal C:\Programs directory, otherwise future updating may fail.

    On a Mac OS X, mount the .dmg and drag the Fiji folder to your applications folder.

    On Linux extract the .gz archive and double click the “run” script.

  3. On Windows, depending on how the downloaded archive was expanded, the ImageJ executable can appear one level deeper in the folder than in ImageJ.

    On Mac OS X, appears as a single .app.


Using ImageJ with OMERO

For ImageJ, two plugins are needed, Bioformats Package and ImageJ/Fiji plugin for OMERO.

First, you need to install Bioformats Package plugin (see below).

  • Download the latest 5.x.x version of the Bioformats Package plugin from:


  • Move the downloaded file into the ImageJ > Plugins folder. The Using Fiji with OMERO
    workflow has some hints about where to find the Plugins folder on your machine.

    Now, install also the ImageJ/Fiji plugin for OMERO as described in Using Fiji with OMERO

    Using Fiji with OMERO

    For Fiji, all you need to do is to install the ImageJ/Fiji plugin for OMERO.

    1. Download the latest 5.x.x version of ImageJ/Fiji plugin for OMERO from:


    2. Extract the downloaded .zip archive. Remember where you extracted it to. Copy the extracted folder and paste it to the Plugins folder of your Fiji.


      Some Windows unzip apps create a double folder enclosing the plugin.
      Check, and if this has happened, copy the inner OMERO.insight-ij-5.x.x folder into the > plugins folder.

      The location of the Plugins folder varies according to where you installed your Fiji or ImageJ. The paths in the screenshots below are just examples:



      If upgrading, delete the previous version of OMERO.insight-ij.


      After installing or upgrading plugins, you need to restart ImageJ or Fiji to be able to use the plugins.

    Accessing OMERO using ImageJ and Fiji

    1. Launch the ImageJ or Fiji application and click on the Plugins menu.

      Select OMERO > Connect to OMERO.

      A version of OMERO.insight will open and can be used as normal.


    2. As ImageJ needs to load the plugin software, it can take a minute or two for the OMERO login screen to appear, and then another two or three minutes for the progress bar to start moving and complete.

      Enter your OMERO server address, if needed, and Username and Password.

      Click Login.


    3. You will then be taken to the OMERO.insight Data Manager screen.


      If you quit OMERO.insight and then connect again during the same ImageJ session, logging in and launching the OMERO plugin will be much quicker. So if you intend using the OMERO plugin through ImageJ again soon, it may be worth leaving your ImageJ application running.

      If you receive the following error message in a dialogue box, this indicates there is a different Java version being used by Fiji from the version required by the OMERO plugin.

      (Fiji Is Just) ImageJ 2.0.0-rc-38/1.50b; Java 1.6.0_65 [64-bit]; Mac OS X 10.8.5; 33MB of 1171MB (2%)

      java.lang.UnsupportedClassVersionError: org/openmicroscopy/shoola/MainIJPlugin : Unsupported major.minor version 51.0

      This plugin requires Java 1.7 or later.

      Update your operating system to the latest version of the Java Development Kit (JDK) using the Java Control Panel (Windows) or the Java System Preference Pane (Mac).

      If the message persists after you have updated your operating system’s JDK, download the latest version of Fiji from the website and this should work with the latest OMERO.insight plugin.

    4. Double click on the image in the data tree or select the image and View > View in ImageJ in the contextual menu.

      The Bio-Formats Import Options window opens.

      Select the check box to set Bio-Formats to automatically check for updates.

      Select parameters and click OK.

      Click OK and the Bio-Formats Import Options window opens.

      Select parameters and click OK.

      Your image will open in the ImageJ viewer.


    Image for link to top of page

    Saving images from ImageJ to OMERO

    With OMERO version 5.1.0 and newer, it is possible to save images directly from ImageJ or Fiji to your OMERO server.

      Use ImageJ or Fiji to open an image from a local disk.


      Plugins > OMERO > Save Image(s) to OMERO.

      A version of OMERO.insight will open automatically.

      The image will be imported into OMERO

      If the image has been modified, e.g. cropped, it will be imported as an OME-TIFF.



    Normal ImageJ conventions with respect to overlays and ROIs are respected when saving to the OMERO server.

    Saving ROIs drawn in ImageJ to OMERO

      Use ImageJ or Fiji to open an image from a local disk or from the OMERO server as described above.

      Draw ROIs in ImageJ or Fiji as normal.

      If the image is from a local disk select:

      Plugins > OMERO > Save Image(s) to OMERO.

      A version of OMERO.insight will open automatically and the image, including the ROIs, will be imported.

      If the image is from the OMERO.server select:

      Plugins > OMERO > Save ROIs to OMERO.

      Once saved to the OMERO.server the ROIs become standard OMERO ROIs and can be used as normal.

      Any existing ROIs on an image in the OMERO server will be displayed and can be manipulated as normal in ImageJ.

      To save the Results Table back to OMERO select:

      Plugins > OMERO > Save Results to OMERO.

      The results will be uploaded and attached to the image in OMERO as a CSV file.



    There is no duplication of data, new or existing ROIs are saved back to the original image on the OMERO server.

    Videos demonstrating Fiji-OMERO workflows

    Videos are available demonstrating the Fiji-OMERO workflows:

    Fiji-OMERO workflow

    Scripting with Fiji and OMERO

    All Tutorial Material is available on line at:

    The Main OME website is at: