Manage Images

Prismic’s image field is a convenient way to add and customize images in your documents. All images are stored in the Media Library, where they are automatically compressed, formatted, and optimized.

Media Library

The Media Library is Prismic’s built-in asset manager. It stores all your uploaded images, videos, and other files so you can reuse them across your content.

When you open the Media Library, you can:

• Upload new files by dragging them into the window or using the Upload button.
• Search, sort, and filter files by name or metadata.
• Select multiple files with Shift-click or Ctrl-click to delete or organize them in bulk.
• Edit metadata, such as alt text, descriptions, tags, and copyright information.

Add a media file

To add an media file to a page, click on the image field. This will open the Media Library. Here, you can upload or select one.

To insert an image, select the one you want and click Add to page. If you upload an image, wait for it to finish loading first.

If responsive views are configured for images in your custom type, arrows will appear next to the inserted image so you can preview how it looks in different layouts.

Delete a media file

If you delete a file from the Media Library, it is removed from the Prismic interface, but the file will remain accessible via its direct URL.

To permanently delete a file from Prismic’s servers, contact us via the help center and send us the file URL to delete.

Edit an image

Once you’ve added an image, you can edit it using the icons next to the image field.

The frame icon opens the image editor, where you can crop and resize the image. If responsive views are configured, you’ll see them listed in the left sidebar and can adjust cropping for each.

The magnifying glass icon lets you replace the image, and the trash icon clears the selection to remove the image from the document.

Add alt text to an image

Alt text describes an image and helps with SEO and accessibility.

You can set alt text in two places:

• In the Media Library: When you upload or select an image, a panel on the right side includes an Alternative text field.
• In a document: After you add an image, an alt text field appears next to it. If the image already has alt text in the Media Library, it will appear here. You can customize the alt text for each document, language, or responsive view.

Add metadata to an image

Along with alt text, you can add other metadata to help organize your assets.

In the Media Library, select an image to open the details panel. You can edit:

• Tags, for categorizing assets.
• Copyright information, for clarifying ownership.
• Private notes, for internal reference and search.

Supported media formats

These image formats are supported:

• PNG
• JPEG
• WEBP
• GIF
• JPE
• JPG
• ICO
• JFIF

Maximum file size

The maximum image size is 10MB. Other file types, including videos, can be up to 100MB.

Video hosting

While you can upload videos, this may quickly consume your CDN allowance. For better performance, we recommend using platforms like YouTube or Vimeo and embedding videos on your website. These services handle video compression and provide optimized playback.