Images and files

Manage your files with the media library

Prismic’s image field makes it easy to add and customize images in your documents. All uploaded assets are stored in the Media Library, where they’re automatically compressed, formatted, and optimized.

Media Library

The Media Library is Prismic’s built-in asset manager for images, videos, and other files. From here, you can upload new assets, search and filter by name or metadata, select multiple files to organize or delete, and edit details like alt text, descriptions, tags, and copyright.

You can filter your search by file type, uploader, or tags, edit alt text and cropping, and add private notes for your team.

Add a media file

When you click an image field, the Media Library opens. You can upload from your computer, pick an existing image, or choose a free stock photo from Unsplash.

For non-image files like PDFs, use a Link field set to Link to Media.

Select your file or image and click Add to page.

Delete a media file

Deleting media removes the file from the interface but leaves it accessible at its direct URL.

Edit an image

Once an image is added, use the crop icon to adjust width, height, and zoom. If responsive views are set up, you can crop each one separately.

Update alt text in the field next to the image, or in the Media Library when selecting it.

Add alt text

Alt text describes an image for accessibility and SEO. It can be set in the Media Library or directly within a page. If an image already has alt text set in the Media Library, it will appear by default in the page. It can be customized for each locale or responsive view.