Upload a file to the Media Library

Last updated Monday, May 23, 2016 in Sitecore Experience Platform for Content Author
Keywords: Media items

In the Media Library, there are three different options to upload your media files:

  • Upload files – use this option to upload a single file or multiple files from the same location.
  • Upload files (advanced) – use this option to apply certain upload options. For example, you can upload a Zip archive or overwrite duplicates.
  • Drag & Drop – use this option to upload a single file or multiple files by dragging them from Windows Explorer to the Sitecore Media Library.

    Note

    The drag-and-drop functionality is currently only supported in Internet Explorer 7 or later. If you use a different browser such as Mozilla Firefox, you must use the Upload files and Upload files (advanced) options to upload your files to the Media Library.

Media files that you upload to the Media Library are not versionable by default. To make a media file versionable means that a new version of the media item is created automatically every time you edit it. In this way, after you have edited a media item, you have the option to revert back to an older version of the item. To make a media file versionable, you must either use the Upload files (advanced) option or set up the Drag & Drop option to make all media files that are uploaded that way versionable by default.

Upload files

To upload a single media file:

  1. In the Media Library, in the content tree, select the folder where you want to upload your media files to.
  2. In the editing pane, on the Folder tab, click Upload files.

    cms_MediaLibrary_ContentArea_Foldertab_Upload

  3. In the Select file(s) to upload dialog box, browse to and select the media file that you want to upload and click Open.

    Note

    To select multiple files, press and hold the CTRL key when you select the files.

    cms_MediaLibrary_UploadFilesDialog

In the editing pane, on the Folder tab and in the Media section, you can see the images that you uploaded. The new items may contain a warning that you can remove, if you open the media item and enter an alternate text in the Alt field.

Upload files (advanced)

To upload files and apply certain upload options:

  1. In the Media Library, in the content tree, select the folder that you want to upload your media files to.
  2. In the editing pane, on the Folder tab, click Upload files (advanced).
  3. In the Select file(s) to upload dialog box, browse to the folder on your computer that contains the images you want to upload.

    Note

    To select multiple files, press and hold the CTRL key when you select the files.

  4. Click Open.
  5. In the Upload Files dialog box, enter an alternate text for each media file and select the relevant upload option check boxes.

    cms_MediaLibrary_UploadFilesDialog_Advanced

Upload option

Description

Unpack ZIP archives

Select this option to upload and extract a Zip archive to the Media Library.

In the .zip file, you can include subfolders with files. The folder structure is re-created in the Media Library after the files are extracted.

Make uploaded media items versionable

Select this option to make the media file versionable. This creates the media file in the selected language only, and any other language version that you want you need to create manually.

Overwrite existing media items

Select this option to upload a file with the same name as a file that already exists in the Media Library, and want to overwrite the existing file.

If you do not select this option, a duplicate file is created in the Media Library.

Upload as files

Select this option to store the file in the file system rather than in the database.

  1. Click Upload and the uploaded images are available in the selected folder in the Media Library.

Drag & Drop

If you work in Internet Explorer 7 or later, the drag-and-drop option is the quickest and easiest way to upload media files to the Media Library. You can upload single or multiple files from your computer to the Drag & Drop dialog box. This is especially useful when you want to upload many files to different locations in Sitecore or from different locations on your computer.

To drag and drop files to the Media Library:

  1. In a Media Library, select the folder that you want to upload the files to.
  2. To open the Drag & Drop dialog box, from the editing pane, on the Folder tab, click Drag & Drop.

    cms_MediaLibrary_DragDropDialog

  3. Open Windows Explorer and navigate to the folder where the images are stored and select the images you want to upload.
  4. Position Windows Explorer next to the Drag & Drop dialog box and drag the selected images from Windows Explorer to the Drag & Drop dialog box.

    cms_MediaLibrary_DragDropDialog_DragItem

    Note

    If you need to upload files to or from other locations, you simply navigate through the folder structure either in the Drag & Drop dialog box or in Windows Explorer. You do not have to close the dialogs and start over.

  5. When you have dragged and dropped all your media files, click Done to copy them to the Media Library.

    Note

    If the folder you copy to already contains a media items with the same name, the Copy File dialog box opens, asking you to decide how to handle the duplicate media items.

    In the editing pane, on the Folder tab and in the Media section, you can now see the images that you uploaded and that each new item contains a warning.

  6. To remove these warnings, open each media item and enter the alternate text in the Alt field.

Make uploaded media files versionable by default

To make all the media files that you upload to the Drop & Drag dialog box versionable by default:

  1. Open the Sitecore.config file that is stored in the web root folder of your website: C:\Inetpub\wwwroot\<YourSitecoreWebsite>\Website
  2. Right-click the Sitecore.config file, click Open With, and then click Notepad.
  3. Locate the following setting and change the value to True:

    <setting name="Media.UploadAsVersionableByDefault" value="false" />

  4. Save your changes.
  5. Open the Media Library.
  6. Click the Sitecore system menu icon_SystemMenu and then click Application Options.
  7. In the Application Options dialog box, click the Media tab, and select the Show only latest version of files option.

Send feedback about the documentation to docsite@sitecore.net.