Single Asset Manifest
For every asset there is a single asset manifest: a IIIF Presentation 3.0 Manifest that includes all the outputs of all the delivery channels specified for the asset.
This manifest has one canvas, with a single painting annotation.
If the asset is an image, audio or video, the canvas dimensions are taken from the source asset. Otherwise, the canvas dimensions are set to width = 1000, height = 1000, with no duration.
The single asset manifest is a public IIIF resource served by the platform, not the API - no API credentials are required.
{public-host}/iiif-manifest/{customer}/{space}/{asset-id}- For the
iiif-imgdelivery channel, the body of the painting annotation is a full/max parameterisation of the v3 image service, with that image service as aserviceproperty of the body image. - For the
iiif-avdelivery channel, the body of the painting annotation is aChoiceresource listing all the transcoded outputs. Each output is a Content Resource with width, height and/or duration, mediaType, label, and additional profile information where available (e.g., codec). - If the asset is an image and does not have the
iiif-imgdelivery channel but does have thethumbsdelivery channel, the body of the painting annotation is a full/max parameterisation of the v3 thumbnail image service.
If the asset has the iiif-img delivery channel, the body of the painting annotation has two services, one for v2 and one for v3 of the Image API. If the asset has access control, the auth services are included inline on the image services.
If the asset has the thumbs delivery channel, the canvas.thumbnail property is an image resource whose id is the full/max parameterisation of the v3 thumbnail image service. This image resource has v2 and v3 thumbnail services.
The output of the file delivery channel is always available as canvas.rendering, with auth services emitted inline if applicable.
If the asset only has the file delivery channel, the body of the canvas painting annotation is a placeholder image provided by the platform. The canvas is then given the additional placeholder behavior, and the rendering is given the additional behavior original.
Any adjuncts with an iiifLink value are expressed under the corresponding IIIF Canvas properties (seeAlso, rendering, annotations, or as inline annotations).
💻 Retrieve a single asset manifest Construct the single asset manifest URL and retrieve the IIIF Manifest
Examples
Section titled “Examples”The following examples show complete IIIF Presentation 3 Manifests for various asset, delivery channel and adjunct combinations. Image and thumbnail service URL patterns are confirmed from real platform output; AV, file delivery and adjunct URL patterns are based on expected platform behaviour.
Image with iiif-img and thumbs
Section titled “Image with iiif-img and thumbs”An image asset registered with both iiif-img and thumbs delivery channels. The manifest carries a thumbnail at the top level (using the platform’s medium thumbnail size) and a label and metadata. The canvas carries the same thumbnail and its own metadata block reflecting the asset’s string, number, tag and role fields. The painting body references the image at the largest available thumbnail size and carries v2 and v3 Image API services pointing to the full-resolution source.
{ "@context": "http://iiif.io/api/presentation/3/context.json", "id": "https://dlcs.example/iiif-manifest/2/5/my-image.jp2", "type": "Manifest", "label": {"en": ["Generated by DLCS"]}, "thumbnail": [ { "id": "https://dlcs.example/thumbs/2/5/my-image.jp2/full/200,133/0/default.jpg", "type": "Image", "width": 200, "height": 133, "format": "image/jpeg", "service": [ { "@context": "http://iiif.io/api/image/2/context.json", "@id": "https://dlcs.example/thumbs/v2/2/5/my-image.jp2", "@type": "ImageService2", "profile": "http://iiif.io/api/image/2/level0.json", "sizes": [ {"width": 1024, "height": 680}, {"width": 400, "height": 266}, {"width": 200, "height": 133}, {"width": 100, "height": 66} ] }, { "@context": "http://iiif.io/api/image/3/context.json", "id": "https://dlcs.example/thumbs/2/5/my-image.jp2", "type": "ImageService3", "profile": "level0", "sizes": [ {"width": 1024, "height": 680}, {"width": 400, "height": 266}, {"width": 200, "height": 133}, {"width": 100, "height": 66} ] } ] } ], "metadata": [ {"label": {"en": ["Title"]}, "value": {"en": ["Created by DLCS"]}}, {"label": {"en": ["Generated On"]}, "value": {"en": ["2026-02-23 09:08:45Z"]}} ], "items": [ { "id": "https://dlcs.example/iiif-img/2/5/my-image.jp2/canvas/c/1", "type": "Canvas", "label": {"en": ["Canvas 1"]}, "width": 4288, "height": 2848, "thumbnail": [ { "id": "https://dlcs.example/thumbs/2/5/my-image.jp2/full/200,133/0/default.jpg", "type": "Image", "width": 200, "height": 133, "format": "image/jpeg", "service": [ { "@context": "http://iiif.io/api/image/2/context.json", "@id": "https://dlcs.example/thumbs/v2/2/5/my-image.jp2", "@type": "ImageService2", "profile": "http://iiif.io/api/image/2/level0.json", "sizes": [ {"width": 1024, "height": 680}, {"width": 400, "height": 266}, {"width": 200, "height": 133}, {"width": 100, "height": 66} ] }, { "@context": "http://iiif.io/api/image/3/context.json", "id": "https://dlcs.example/thumbs/2/5/my-image.jp2", "type": "ImageService3", "profile": "level0", "sizes": [ {"width": 1024, "height": 680}, {"width": 400, "height": 266}, {"width": 200, "height": 133}, {"width": 100, "height": 66} ] } ] } ], "metadata": [ {"label": {"none": ["String 1"]}, "value": {"none": [""]}}, {"label": {"none": ["String 2"]}, "value": {"none": [""]}}, {"label": {"none": ["String 3"]}, "value": {"none": [""]}}, {"label": {"none": ["Number 1"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Number 2"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Number 3"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Tags"]}, "value": {"none": [""]}}, {"label": {"none": ["Roles"]}, "value": {"none": [""]}} ], "items": [ { "id": "https://dlcs.example/iiif-img/2/5/my-image.jp2/canvas/c/1/page", "type": "AnnotationPage", "items": [ { "id": "https://dlcs.example/iiif-img/2/5/my-image.jp2/canvas/c/1/page/image", "type": "Annotation", "motivation": "painting", "body": { "id": "https://dlcs.example/iiif-img/2/5/my-image.jp2/full/1024,680/0/default.jpg", "type": "Image", "width": 1024, "height": 680, "format": "image/jpeg", "service": [ { "@context": "http://iiif.io/api/image/2/context.json", "@id": "https://dlcs.example/iiif-img/v2/2/5/my-image.jp2", "@type": "ImageService2", "profile": "http://iiif.io/api/image/2/level2.json", "width": 4288, "height": 2848 }, { "@context": "http://iiif.io/api/image/3/context.json", "id": "https://dlcs.example/iiif-img/2/5/my-image.jp2", "type": "ImageService3", "profile": "level2", "width": 4288, "height": 2848 } ] }, "target": "https://dlcs.example/iiif-img/2/5/my-image.jp2/canvas/c/1" } ] } ] } ]}Image with iiif-img, thumbs and adjuncts
Section titled “Image with iiif-img, thumbs and adjuncts”The same image as above with four adjuncts, one for each iiifLink value. The seeAlso, rendering, annotations and inlineAnnotation adjuncts appear under the corresponding canvas properties.
{ "@context": "http://iiif.io/api/presentation/3/context.json", "id": "https://dlcs.example/iiif-manifest/2/5/my-image.jp2", "type": "Manifest", "label": {"en": ["Generated by DLCS"]}, "thumbnail": [ { "id": "https://dlcs.example/thumbs/2/5/my-image.jp2/full/200,133/0/default.jpg", "type": "Image", "width": 200, "height": 133, "format": "image/jpeg", "service": [ { "@context": "http://iiif.io/api/image/2/context.json", "@id": "https://dlcs.example/thumbs/v2/2/5/my-image.jp2", "@type": "ImageService2", "profile": "http://iiif.io/api/image/2/level0.json", "sizes": [ {"width": 1024, "height": 680}, {"width": 400, "height": 266}, {"width": 200, "height": 133}, {"width": 100, "height": 66} ] }, { "@context": "http://iiif.io/api/image/3/context.json", "id": "https://dlcs.example/thumbs/2/5/my-image.jp2", "type": "ImageService3", "profile": "level0", "sizes": [ {"width": 1024, "height": 680}, {"width": 400, "height": 266}, {"width": 200, "height": 133}, {"width": 100, "height": 66} ] } ] } ], "metadata": [ {"label": {"en": ["Title"]}, "value": {"en": ["Created by DLCS"]}}, {"label": {"en": ["Generated On"]}, "value": {"en": ["2026-02-23 09:08:45Z"]}} ], "items": [ { "id": "https://dlcs.example/iiif-img/2/5/my-image.jp2/canvas/c/1", "type": "Canvas", "label": {"en": ["Canvas 1"]}, "width": 4288, "height": 2848, "thumbnail": [ { "id": "https://dlcs.example/thumbs/2/5/my-image.jp2/full/200,133/0/default.jpg", "type": "Image", "width": 200, "height": 133, "format": "image/jpeg", "service": [ { "@context": "http://iiif.io/api/image/2/context.json", "@id": "https://dlcs.example/thumbs/v2/2/5/my-image.jp2", "@type": "ImageService2", "profile": "http://iiif.io/api/image/2/level0.json", "sizes": [ {"width": 1024, "height": 680}, {"width": 400, "height": 266}, {"width": 200, "height": 133}, {"width": 100, "height": 66} ] }, { "@context": "http://iiif.io/api/image/3/context.json", "id": "https://dlcs.example/thumbs/2/5/my-image.jp2", "type": "ImageService3", "profile": "level0", "sizes": [ {"width": 1024, "height": 680}, {"width": 400, "height": 266}, {"width": 200, "height": 133}, {"width": 100, "height": 66} ] } ] } ], "seeAlso": [ { "id": "https://dlcs.example/adjuncts/2/5/my-image.jp2/alto.xml", "type": "Dataset", "profile": "http://www.loc.gov/standards/alto/v3/alto.xsd", "label": {"en": ["METS-ALTO XML"]}, "format": "text/xml", "language": ["en-GB", "cy"] } ], "annotations": [ { "id": "https://dlcs.example/adjuncts/2/5/my-image.jp2/anno.json", "type": "AnnotationPage", "label": {"en": ["Line-level annotations"]}, "language": ["en", "cy"] }, { "id": "https://dlcs.example/adjunct-annotations/2/5/my-image.jp2", "type": "AnnotationPage", "label": {"en": ["Inline annotations"]}, "items": [ { "id": "https://dlcs.example/adjunct-annotations/2/5/my-image.jp2/text.txt", "type": "Annotation", "motivation": ["supplementing"], "provides": ["transcript"], "body": [ { "id": "https://dlcs.example/adjuncts/2/5/my-image.jp2/text.txt", "type": "Text", "format": "text/plain", "label": {"en": ["Plain text of this page"]}, "language": ["en", "cy"] } ], "target": ["https://dlcs.example/iiif-img/2/5/my-image.jp2/canvas/c/1"] } ] } ], "rendering": [ { "id": "https://dlcs.example/adjuncts/2/5/my-image.jp2/preview.jpg", "type": "Image", "label": {"en": ["A JPEG of the asset"]}, "format": "image/jpeg" } ], "metadata": [ {"label": {"none": ["String 1"]}, "value": {"none": [""]}}, {"label": {"none": ["String 2"]}, "value": {"none": [""]}}, {"label": {"none": ["String 3"]}, "value": {"none": [""]}}, {"label": {"none": ["Number 1"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Number 2"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Number 3"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Tags"]}, "value": {"none": [""]}}, {"label": {"none": ["Roles"]}, "value": {"none": [""]}} ], "items": [ { "id": "https://dlcs.example/iiif-img/2/5/my-image.jp2/canvas/c/1/page", "type": "AnnotationPage", "items": [ { "id": "https://dlcs.example/iiif-img/2/5/my-image.jp2/canvas/c/1/page/image", "type": "Annotation", "motivation": "painting", "body": { "id": "https://dlcs.example/iiif-img/2/5/my-image.jp2/full/1024,680/0/default.jpg", "type": "Image", "width": 1024, "height": 680, "format": "image/jpeg", "service": [ { "@context": "http://iiif.io/api/image/2/context.json", "@id": "https://dlcs.example/iiif-img/v2/2/5/my-image.jp2", "@type": "ImageService2", "profile": "http://iiif.io/api/image/2/level2.json", "width": 4288, "height": 2848 }, { "@context": "http://iiif.io/api/image/3/context.json", "id": "https://dlcs.example/iiif-img/2/5/my-image.jp2", "type": "ImageService3", "profile": "level2", "width": 4288, "height": 2848 } ] }, "target": "https://dlcs.example/iiif-img/2/5/my-image.jp2/canvas/c/1" } ] } ] } ]}Audio with iiif-av
Section titled “Audio with iiif-av”An audio asset on the iiif-av delivery channel. The canvas has only duration — no visual dimensions and no thumbnail. The painting body is a Choice wrapping the single transcoded output.
{ "@context": "http://iiif.io/api/presentation/3/context.json", "id": "https://dlcs.example/iiif-manifest/2/5/my-audio.mp3", "type": "Manifest", "label": {"en": ["Generated by DLCS"]}, "metadata": [ {"label": {"en": ["Title"]}, "value": {"en": ["Created by DLCS"]}}, {"label": {"en": ["Generated On"]}, "value": {"en": ["2026-02-23 09:08:45Z"]}} ], "items": [ { "id": "https://dlcs.example/iiif-av/2/5/my-audio.mp3/canvas/c/1", "type": "Canvas", "label": {"en": ["Canvas 1"]}, "duration": 300, "metadata": [ {"label": {"none": ["String 1"]}, "value": {"none": [""]}}, {"label": {"none": ["String 2"]}, "value": {"none": [""]}}, {"label": {"none": ["String 3"]}, "value": {"none": [""]}}, {"label": {"none": ["Number 1"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Number 2"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Number 3"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Tags"]}, "value": {"none": [""]}}, {"label": {"none": ["Roles"]}, "value": {"none": [""]}} ], "items": [ { "id": "https://dlcs.example/iiif-av/2/5/my-audio.mp3/canvas/c/1/page", "type": "AnnotationPage", "items": [ { "id": "https://dlcs.example/iiif-av/2/5/my-audio.mp3/canvas/c/1/page/audio", "type": "Annotation", "motivation": "painting", "body": { "type": "Choice", "items": [ { "id": "https://dlcs.example/iiif-av/2/5/my-audio.mp3/mp3-320", "type": "Sound", "format": "audio/mpeg", "duration": 300, "label": {"en": ["MP3 320kbps"]} } ] }, "target": "https://dlcs.example/iiif-av/2/5/my-audio.mp3/canvas/c/1" } ] } ] } ]}Video with iiif-av
Section titled “Video with iiif-av”A video asset on the iiif-av delivery channel with two transcoded outputs. The canvas has width, height and duration. The painting body is a Choice wrapping the two outputs.
{ "@context": "http://iiif.io/api/presentation/3/context.json", "id": "https://dlcs.example/iiif-manifest/2/5/my-video.mp4", "type": "Manifest", "label": {"en": ["Generated by DLCS"]}, "metadata": [ {"label": {"en": ["Title"]}, "value": {"en": ["Created by DLCS"]}}, {"label": {"en": ["Generated On"]}, "value": {"en": ["2026-02-23 09:08:45Z"]}} ], "items": [ { "id": "https://dlcs.example/iiif-av/2/5/my-video.mp4/canvas/c/1", "type": "Canvas", "label": {"en": ["Canvas 1"]}, "width": 1920, "height": 1080, "duration": 600, "metadata": [ {"label": {"none": ["String 1"]}, "value": {"none": [""]}}, {"label": {"none": ["String 2"]}, "value": {"none": [""]}}, {"label": {"none": ["String 3"]}, "value": {"none": [""]}}, {"label": {"none": ["Number 1"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Number 2"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Number 3"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Tags"]}, "value": {"none": [""]}}, {"label": {"none": ["Roles"]}, "value": {"none": [""]}} ], "items": [ { "id": "https://dlcs.example/iiif-av/2/5/my-video.mp4/canvas/c/1/page", "type": "AnnotationPage", "items": [ { "id": "https://dlcs.example/iiif-av/2/5/my-video.mp4/canvas/c/1/page/video", "type": "Annotation", "motivation": "painting", "body": { "type": "Choice", "items": [ { "id": "https://dlcs.example/iiif-av/2/5/my-video.mp4/mp4-1080p", "type": "Video", "format": "video/mp4", "width": 1920, "height": 1080, "duration": 600, "label": {"en": ["1080p H.264"]} }, { "id": "https://dlcs.example/iiif-av/2/5/my-video.mp4/mp4-480p", "type": "Video", "format": "video/mp4", "width": 854, "height": 480, "duration": 600, "label": {"en": ["480p H.264"]} } ] }, "target": "https://dlcs.example/iiif-av/2/5/my-video.mp4/canvas/c/1" } ] } ] } ]}Non-image file on file channel only
Section titled “Non-image file on file channel only”A non-image asset (Word document) with only the file delivery channel. The canvas defaults to 1000×1000 and is given behavior: ["placeholder"]. The painting body is a placeholder image provided by the platform. The file download appears in canvas.rendering with behavior: ["original"].
{ "@context": "http://iiif.io/api/presentation/3/context.json", "id": "https://dlcs.example/iiif-manifest/2/5/my-document.docx", "type": "Manifest", "label": {"en": ["Generated by DLCS"]}, "metadata": [ {"label": {"en": ["Title"]}, "value": {"en": ["Created by DLCS"]}}, {"label": {"en": ["Generated On"]}, "value": {"en": ["2026-02-23 09:08:45Z"]}} ], "items": [ { "id": "https://dlcs.example/iiif-manifest/2/5/my-document.docx/canvas/c/1", "type": "Canvas", "label": {"en": ["Canvas 1"]}, "width": 1000, "height": 1000, "behavior": ["placeholder"], "rendering": [ { "id": "https://dlcs.example/file/2/5/my-document.docx", "type": "Text", "format": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "label": {"en": ["Original Word document"]}, "behavior": ["original"] } ], "metadata": [ {"label": {"none": ["String 1"]}, "value": {"none": [""]}}, {"label": {"none": ["String 2"]}, "value": {"none": [""]}}, {"label": {"none": ["String 3"]}, "value": {"none": [""]}}, {"label": {"none": ["Number 1"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Number 2"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Number 3"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Tags"]}, "value": {"none": [""]}}, {"label": {"none": ["Roles"]}, "value": {"none": [""]}} ], "items": [ { "id": "https://dlcs.example/iiif-manifest/2/5/my-document.docx/canvas/c/1/page", "type": "AnnotationPage", "items": [ { "id": "https://dlcs.example/iiif-manifest/2/5/my-document.docx/canvas/c/1/page/image", "type": "Annotation", "motivation": "painting", "body": { "id": "https://dlcs.example/placeholder/2/5/my-document.docx", "type": "Image", "format": "image/png" }, "target": "https://dlcs.example/iiif-manifest/2/5/my-document.docx/canvas/c/1" } ] } ] } ]}Image with no delivery channels
Section titled “Image with no delivery channels”An image that has been registered but has no delivery channels configured. The manifest and canvas still carry label and metadata, and the canvas has the correct dimensions taken from the source asset, but there is no painting annotation.
{ "@context": "http://iiif.io/api/presentation/3/context.json", "id": "https://dlcs.example/iiif-manifest/2/5/my-image.jp2", "type": "Manifest", "label": {"en": ["Generated by DLCS"]}, "metadata": [ {"label": {"en": ["Title"]}, "value": {"en": ["Created by DLCS"]}}, {"label": {"en": ["Generated On"]}, "value": {"en": ["2026-02-23 09:08:45Z"]}} ], "items": [ { "id": "https://dlcs.example/iiif-manifest/2/5/my-image.jp2/canvas/c/1", "type": "Canvas", "label": {"en": ["Canvas 1"]}, "width": 4288, "height": 2848, "metadata": [ {"label": {"none": ["String 1"]}, "value": {"none": [""]}}, {"label": {"none": ["String 2"]}, "value": {"none": [""]}}, {"label": {"none": ["String 3"]}, "value": {"none": [""]}}, {"label": {"none": ["Number 1"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Number 2"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Number 3"]}, "value": {"none": ["0"]}}, {"label": {"none": ["Tags"]}, "value": {"none": [""]}}, {"label": {"none": ["Roles"]}, "value": {"none": [""]}} ], "items": [] } ]}