Several types of media are allowed including images, documents, audio files and content from external sources like YouTube, Vimeo, Twitter, Facebook, Instagram and the University of Iowa's UI Capture (Panopto) service.

With all of these media types, you can add them from other content through fields and the WYSIWYG for display.

Each of the media types have specific documentation, but there are some shared functionality to highlight.

You can either add them directly to your site by going to Content > Media (/admin/content/media), or as you create content through fields and WYSIWYG text editors.

Replace File

When editing media from the Media overview page (admin/content/media), you have the option to overwrite the existing file. This is the default behavior and is indicated by the checked "Overwrite original file" checkbox. This will overwrite the existing file and use the same directory and filename (e.g. ../2020-09/filename.pdf). This can be useful if you have sent out hard-coded links in emails or other communications. 

If you uncheck "Overwrite original file", the media object will point to a new file with a different name. The old file, if not used elsewhere, will be deleted eventually.

Regardless of whether "Overwrite original file" is checked or not, updating a file will update any content where the media has been placed/referenced as long as it is not a hard-coded link, e.g. File fields and the WYSIWYG media button use special markup to reference media objects that is converted dynamically so you don't have to worry about updating links to files.


When replacing certain media types like images and audio, the changes may not be immediately apparent. This is because browsers display a cached copy, if previously downloaded, for a period of time. People visiting your site for the first time should see the new media immediately. However, to force browsers to download the new image if previously cached, you can uncheck "Overwrite original file" when editing media.