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.
| Approach | Host in Micrio | Keep your IIIF server | Viewer only |
|---|---|---|---|
| Micrio stores and serves the image tiles | Yes | No | No |
| Micrio editor and storytelling | Yes | Yes | No |
| Image source | Your original files | Your IIIF server | Your IIIF server |
| How to start | Upload the originals | Contact 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:
<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.