Skip to end of metadata
Go to start of metadata

See also: Media Library: File Management StandardsFile Naming Conventions and Best Practices

In Sitecore, the Media Library contains all the images and documents (PDFs, word documents, spreadsheets, etc.) that are used on or linked to from our website. In this tutorial we demonstrate how to add a new file to the media library and how to manually publish a media library item.


Coming soon


  • Go to the media library
  • Select the folder you want to upload your image to
  • Click on "Upload Files (Advanced)"
  • Browse and select the files you want to upload and click "Upload"
  • Add alternative text to each image
  • Make sure each image meets our file naming an accessibility standards

Step-by-step Guides

Adding a File to the Media Library

There are a couple ways to add new content to the Media Library, but the recommended way is as follows.

  1. First re-size your images to be the correct size, optimize them for the web, and ensure they meet the File Naming Conventions and Best Practices.
  2. Then, log into Sitecore.
  3. In the bottom left corner of the page there will be three tabs. Content Editor will currently be selected. Click on the Media Library tab.
  4. Next, navigate to the directory that contains your content. For most content pages this will be somewhere under the 'Bus' directory (which should mimic the normal content tree).
  5. Once you've selected the directory your content should live in you will see a couple options, if you have access to the directory. If you want to create a new folder click on the New Folder icon. To add a new image or document, use the Upload Files (Advanced) option.

    Select the Media Library tab and then either Upload Files (Advanced) or New Folder.

  6. At this point you'll be prompted to select the files. After selecting each file click "Open".
  7. Alternative text should be added to all images. PDFs and other documents do not need alternate text.
    1. Click on each image in the "Uploaded Media Library items:" field to open the item/click "Lock and Edit" and add alternative text, and click "Save and Close".
    2. The alternate text should be populated, and will help those who can't see the images, for whatever reason, understand what they convey.

      Screen shot of Upload Files Advanced and Batch Upload Settings

  8. The other options can be left with their default values. 
  9. Then, when all your files have been added click "Upload".
  10. You can now switch back to the Content Editor tab and add your image(s) to your content. At this time, verify that the alternate text is correct, and if needed for this particular page, tweak as needed.

    Click the Insert Sitecore Media button, select your image, and then click the Insert button.

Inclusive Design and Accessibility Resources

Inclusive Design and Accessibility Resources

Accessibility Settings for PDFs

All PDFs that are linked to on the website should be accessible. The campus resources Accessibility compliance: PDF files without images outlines the minimum accessibility standards for PDFs. Please see our Accessibility Compliance and Inclusive Design: Resources or the Webaim PDF Accessibility standards for more information.

Accessibility Settings for Images

All images used on the website should be accessible and have alternative text.. Please see the Webaim Accessible Images and Alternative Text standards for more information.

Quick -Tip Error Uploading Files

File Names and Errors Uploading into Sitecore

If your file has special characters (such as !#$%&'*+/=?^`{|}~; etc) , that could be generating an error on Sitecore.  Media library item file names should contain lowercase letters and dashes instead of spaces. Additionally, the only period in the filename should be the one that is a part of the file type, which should be handled for you by the program that saved the file (for example photo-name.jpg). 

Manually Publishing Media Items

For the majority of media items you do not need to worry about publishing them, since they're automatically published when you publish the page that uses or links to them.

However, in some cases you may need to publish a media item manually, such as for the current newsletter generator.

To manually publish a media item navigate to the item and click the Publish Media Item button in the WSoB tab.

Publish media manually by using the Publish Media Item button in the WSoB tab.

After clicking, you should see a message and within 5 minutes the media should be published. If updating an existing item, a hard refresh (Ctrl + F5 on Windows) may be necessary.

How-to Add Alternative Text to Media Library Items

  1. Go to each item in the Media Library.
  2. Click "Lock and Edit".
  3. Add alternative text to the "Alt" field.
  4. Click "Save".
  5. Click "Publish Media Library item".

Learn More

Next Tutorial