Skip to content

Importing from IIIF ​

If your images are served by a IIIF Image API server, or described in IIIF Presentation API manifests, there are three ways to use them in Micrio. The right choice depends on whether you want Micrio to host the images, whether you want to keep your own IIIF server, or whether you only need to display the images.

ApproachHost in MicrioKeep your IIIF serverViewer only
Micrio stores and serves the image tilesYesNoNo
Micrio editor and storytellingYesYesNo
Image sourceYour original filesYour IIIF serverYour IIIF server
How to startUpload the originalsContact us (experimental)Embed a IIIF URL

Host the collection in Micrio ​

If you want Micrio to serve the images, including through its own IIIF Image API and Presentation API, add the original image files to Micrio. Use the Dashboard to upload images to a folder or image album, or use the Micrio Server API or CLI tool for larger collections. See Migrating your collection for the available options.

Prefer the original files (or the closest version you have) over the IIIF server's output. IIIF servers often limit the resolution they return and may compress the image as JPEG; using that output as the source for a Micrio image can therefore give a lower-resolution result with extra compression. If the originals are no longer available, download the highest-resolution version your server allows and check the maxWidth, maxHeight, maxArea and available formats in the image's info.json first.

Micrio stores a copy of each uploaded image, so later changes to the source file require a new upload.

Keep your own IIIF server ​

If you want to keep your existing IIIF server as the image source, and use Micrio for storytelling, Micrio has an experimental IIIF importer. It adds the existing IIIF resources to your Micrio dashboard, where they get their own Micrio IDs, so you can enrich and publish them from Micrio. Micrio does not copy or host the image tiles; your IIIF server remains the source.

The importer is experimental and is enabled per organisation by Micrio. It is not a self-service feature. Contact us to discuss your collection and whether the importer fits. Because the images stay on your IIIF server, their quality depends on that server's settings (maximum output size and compression). Importing a IIIF collection is a project to plan, not a standard upload.

Display IIIF images in the viewer ​

If you only need to display images from another IIIF server, you do not have to import them. Use the IIIF Presentation API v3 manifest URL, or the IIIF Image API v3 ID, as the <micr-io> id:

html
<micr-io id="https://example.org/iiif/manifest.json"></micr-io>

The image stays on the other server. It does not get a Micrio ID, and it cannot be edited or added to Micrio albums. See Micrio as IIIF Viewer client for details.

Need help choosing an approach? Contact us, we're happy to help.