Media

This article explains the menu item Media, which you can find under Content > Media. Here you can upload new media files, sort them into folders and manage existing media files. 
This files, you can use in other places in your shop (storefront, products, ...).

Overview

At the top you will find the search function, with which you can search media files.
Below you will find the Upload file button (1), which you can use to upload media from your local computer. You can use the arrow to the right of the button to upload publicly accessible media via a URL. 

On the left side you see the overview of all media files listed with name and preview picture. In the upper right corner of this overview you can choose the way of presentation with the Presentation button (2) and the way of sorting with the Sort by button (3) 
Via the button Add new folder (4) you can create a new folder at the exact place in the folder structure, where you are and name it. When you select a medium or a folder in the overview, you will find all information and actions (6) for this object on the right side.
You can also access the actions via the context menu (5) in the upper right corner of the medium.
 

File upload in the Media Manager supports the following file types:
jpg, jpeg, png, webp, gif, svg, bmp, tiff, tif, eps, webm, mkv, flv, ogv, ogg, mov, mp4, avi, wmv, pdf, aac, mp3, wav, flac, oga, wma, txt, doc, glb

File already exists

As mentioned above, you can upload files using button (1). For example, if you want to upload an image that has already been uploaded before, a pop-up will appear.

Here you have different options how to proceed.
Upload and replace: This will replace the previous file with the new one.
Upload and rename: The new file will be uploaded, but under a different name.
Use existing file: The already existing file will be used.
Skip file: This option only appears when you upload more than two files.

Media configuration

Actions

Replace - With this function you can replace an already uploaded medium with another one, which you upload in the next step.

 

Download - Starts the download of the selected media files. 

Move - Here you can move the selected media files to another folder.

Copy link - copies the URL from the selected media file.

Delete - Deletes the selected media file. 

Preview

Here you can see a preview of the selected media. 

Meta data

Here you can find the metadata of the selected media file and here you can change the name, the alt-text and the meta-title of the media file. 

 

Tags

Here you can set up tags so you can find them better. 

Used in

In this area you can see where in your shop you are using the selected medium. The places where the medium is used are directly linked and can be accessed by clicking directly. 

Delete unused media

Unused media can take up a lot of storage space and make the media overview confusing, so it can be useful to delete them. It is particularly useful to delete a large number of unused media via the console.  

Unused media can be deleted via the console using the command media:delete-unused.

You can find more information and further CLI commands here in our documentation.

Folder

The media can be sorted in folders for better overview and processing. You can create as many folders and subfolders as you want and move the media to these folders.

Add new folder

By clicking on the button Add new folder, you can add a new folder at the exact place in the folder structure, where you are and name it. A new folder with a folder symbol will be displayed in the overview next to the existing media and folders. You can then open the folder with this icon.

 

In the folder you can jump back to a higher folder level by clicking on the Back icon.

 

 

Actions

As with the media files, the actions of the selected folder are displayed on the right side.

Move - Here you can move the folder to another existing folder.
Settings - Here you can open the folder settings. 
Dissolve - Here you can dissolve the folder. The folder will be removed and all folders and media that were in the folder will be moved to the folder above it. 
Delete - This deletes the entire folder including all its contents.

Settings

The settings of the folder are divided into the general settings and the thumbnail settings.

Settings

In the general settings you can change the name of the folder on the one hand and on the other hand you can specify for which media files this folder should serve as default location. For example, this could be all product media files.

Thumbnails

In the thumbnail settings you can define all settings for the thumbnails that are used in the frontend, for example. If you activate the option Inherit settings from parent folder (1), the same thumbnail settings will be used for the current folder as in the parent folder. With the checkbox Generate thumbnails for this folder (2) you can completely activate or deactivate thumbnail generation for this folder. With Keep aspect ratio (3) you keep the aspect ratio of the original image. This ensures that a rectangular image is not distorted with square thumbnail settings. In the field Thumbnail quality (4) you can determine the quality of the thumbnails. 100 here means a very high quality, 1 a very low quality.
Under Thumbnail Size (5) you can define for which sizes thumbnails should be created. Via the link Edit list in the upper right corner you can remove existing thumbnail sizes by clicking the red X. You can also add new thumbnail sizes (6). If the lock symbol is activated, the width is automatically equal to the height.

The three default thumbnail sizes for all uploaded images are 400x400, 800x800, and 1920x1920.