Images - Media library through components

Sitecore Media Library is the tool you use to upload, store, and serve images on your website. Images are generally one of the largest assets that contribute to long page load times. To maintain a good user experience, we should do our best to keep page load times low.

On This Page

Looking for information on adding videos or documents to your website? See our documentation.


Sitecore Media Library

Images that you use on your website are uploaded and served through the Sitecore Media Library. It supports all standard image formats such as JPG, GIF, PNG, and SVG. You’re also free to manage your images as you go because our components provide you with a direct interface to upload and select images as you work.


Selecting Images in Components

Components that support images include a field in the content edit window that allows you to directly access the Sitecore Media Library.

  1. Scroll to the Image field in the Edit window and click the Browse button. The Select Media window will open.

  2. Find and select the image that you want to insert from the Media Library. There are multiple ways to locate the image you want:

    1. navigate through the content tree

    2. search for the item on the Search field

    3. use one of the many predefined filters or presets like My images or Recently uploaded by me

  3. Click the image you want and then click the blue Select button in the lower right of the window. The Select Media window will close and you will be returned to the Edit window to continue editing other content fields.


Uploading Images

If your image does not exist in the Media Library, you can upload it from the same Select Media window that you used to select images.

  1. Scroll to the Image field in the Edit window and click the Browse button. The Select Media window will open.

  2. Click the blue Upload button in the top left. The Upload Media window will open.

  3. Click the gray Change Destination button in the upper right. The Media Library file tree will expand allowing you to find the appropriate destination folder for your image.

  4. Click the appropriate folder. The Media Library file tree will close itself and you will see the new destination you have set.

  5. Upload your image by either dragging and dropping it into the labeled area or clicking the Browse for media files button. Your new image will appear on the screen with a preview, information fields, file statistics, and a button to remove it.

  6. Fill in the Alternate text field with a short description of the image. This step is important as it allows visitors with screen readers to understand your image without having to see it.

  7. If needed, upload additional images following the same drag and drop area or Browse for media files button.

  8. Click the Upload media button and your images are now in the Media Library ready to be selected.


Restricted Folders

You can only upload images into Media Library folders that you have permissions to use.

  • If you try to upload an image into a folder that is not connected to your website’s permissions, the upload will fail.

  • Sitecore displays this failure by outlining the item in red and displaying an admittedly confusing message of “Not Found” This is not an error, it just means you do not have permission to use that folder.

Solution: Click the Change Destination button at the top-right of the window and use the destination tree to find and select a folder related to the website you are editing.


Free Image Editing Software

You don’t need an expensive Adobe Photoshop subscription just to resize images. Below is some free image editing software you can take advantage of:

Built-In Applications

  • Windows: Microsoft Paint

  • Mac: Preview

3rd Party

The web team is working on new ways to streamline this process for you and we hope to have more to share in the future.


Was this helpful? We welcome feedback for this Sitecore documentation: Take the User Survey