May 16, 2022

International Image Interoperability Framework (IIIF) Announces Publication of New Content State API

From an IIIF (International Image Interoperability Framework) Post:

The IIIF Discovery Technical Specification group and the IIIF Editorial Committee are pleased to announce the official publication of the new Content State API specification after a unanimous vote of approval from the Technical Review Committee. This bring the total number of official IIIF API specifications to six.

As IIIF Editor Tom Crane puts it, “IIIF Content State is how we point at things in IIIF” – i.e., a means to generate a very specific link to a particular view of an object, like a specific area on a particular page rotated at a certain angle.

Example use cases for sharing a resource, or a particular view of a resource, include:

  • A user follows a link from a search result, which opens a IIIF viewer. The viewer focuses on the relevant part of the object, such as a particular line of text that contains the searched-for term.
  • A user opens several IIIF manifests [What’s a manifest?] to compare paintings, then wishes to share this set of views with a colleague.

Other examples include bookmarks, citations, playlists and deep linking into digital objects.

For a non-technical overview, see “What is IIIF Content State” by IIIF Editor Tom Crane.

There are already a number of implementations of the new standard, including the virally popular Animal Crossing Art Generator from the Getty.

About Gary Price

Gary Price ( is a librarian, writer, consultant, and frequent conference speaker based in the Washington D.C. metro area. Before launching INFOdocket, Price and Shirl Kennedy were the founders and senior editors at ResourceShelf and DocuTicker for 10 years. From 2006-2009 he was Director of Online Information Services at, and is currently a contributing editor at Search Engine Land.