Last updated: July 10, 2023
The Media Library icon allows users to:
- upload new images
- browse the media library for existing images
- upload new documents (PDFs, Word docs)
- resize and crop images within the media library
Please do not use the Media Library to upload videos. Use the Video Embed icon to add videos to your page.
Adding a New Image to the Page
*Click here for image prep guidelines
- Make sure that the Body Field's text format is toggled to Full HTML
- Place your cursor at the start of the line where you want the image added
Click the Insert from Media Library icon
Click the Select files button under Add File
- Browse your computer and select the compressed/cropped image
- Add the required alternative text. Alternative text is important for accessibility as it describes the content of images
- Add title text (optional). Title text is used as a tool tip when the user hovers the mouse over the image
Click the blue Save and Select button
Click the blue Insert Selected button
- Click the gray Edit Media button at the top left of the newly uploaded image if you'd like to update the alternative text, set image alignment or add an image caption
- Click the blue Save button at the bottom of the page once done
Adding an Existing Media Library Image to the Page
- Place your cursor at the start of the line where you want the image added
- Click the Insert from Media Library icon
- Below the Add File dialog box, either type in the image file name in the Name search field or scroll through the image library
- Select the image and click the blue Insert Selected button
- Click the gray Edit Media button at the top left of the newly uploaded image if you'd like to update the alternative text, set image alignment or add an image caption
- Click the blue Save button at the bottom of the page once done
Upload a Document Media Type (pdf):
Using ‘Full HTML’ text format, within the Body field, click the ‘Insert from Media Library’ tool bar button.
Select the Document link on the left sidebar of the modal.
- Click the Browse button under Add File and select a document file to upload.
- The document will upload to page.
To edit the document’s link description:
- Click the ‘Edit media’ button of the uploaded document.
- Within the Edit media modal, click ‘Edit this media’ button.
- Within the Edit Document modal, add or edit the Description field for the document. This field will be the link to the document.
- Click the Save button.
Please Note: Documents uploaded as media content, are block level elements, wrapped in article tags.
Adding PDF/document as an inline link
If you need an inline link (documents within a paragraph for instance), or an inline pdf, the best option is to use the ‘Link’ toolbar button and then use the IMCE File Browser to upload the document, so that the link remains in-line with the surrounding text.
- Type or paste in the text you'd like to link. Then highlight that text.
Click the Link tool button on the CKEditor toolbar.
Click Open File Browser within the Add Link modal
- Once within the file browser, wait for the public:// directory to load - it may take a minute.
- Click the Upload button at the top
Click the green +Add File button
- Click the Select button at the top
- Click the Save button on the Add Link modal window
- The link is pasted in-line with the surrounding text in the Body field
Media Editing and Cropping Tools
To resize or crop an image, please read the Media Editing and Cropping Tools user guide here.