Media List

Synchronize media to VirtueMart

This is a useful function (for some users) shown in the top Toolbar of the media list.

Some users will upload their media/image files directly into the image folders configured for VirtueMart such as /products, /category.

If you have uploaded images in this way, they need to be referenced in a VirtueMart media table before they can be used by VirtueMart

The Synchronise media to VirtueMart action will create a reference in the database for non-referenced media - allowing you to select and use them within VM.

The alternative is to upload media as part of a record edit or addition e.g. Product/Category/Manufacturer, using the options available in the edit functions.


A list of media files available for use in your store.


Filters can be applied to the list to restrict the images that are shown,

Filter Name

Type a fileame into this field if you search for a single media file and you know the filename or at least parts of the filename.

Go Click this button to apply any selected filter(s)

Reset Click this button to clear any applied selected filter(s)


Search for all types of media or select one from the dropdown list.


Use to filter for media which do have a database entry but don't exist in the VirtueMart image folders anymore.

Orphaned Media

Tick to list media not allocated to any record in your store.  This option can help you clear up old/unused media.

Select Vendor

Here you can limit your search to a certain vendor in case you operate a multi-vendor shop.

Media list columns explained

File title

Click to sort the list by the ‘Unique Filename’.


Click to sort the list by the media file role


Displays thumbnail images of the media files.


The stored filenames of the media files.

File type

The file type of the media files, e.g. jpg, png, pdf.


The Media published state - if not published, the media is not available. Click to sort the list by this column.


The virtuemart_media_id - unique ID. Click to sort the list by ID.

vm documentation

General concepts

New to Virtuemart, take a look at some of the general concepts before you dive in deeper.

vm admin

VirtueMart Manuals

Learn the purpose of the VirtueMart component menus.
Decide how you should setup your store ready for trading.

vm tutorials

VirtueMart Tutorials

A great place to start if you want to learn more, before diving into configurations.
Also useful for updating your overall knowledge of VirtueMart.

vm faq

VirtueMart FAQ

The best place for answers is in the Virtuemart forums. We have gathered a few top questions and answered them here.

vm api

VirtueMart API

Need something more technical.
Our API doc site may be what you are looking for.