WP Media Folder documentation


WP Media Folder is a WordPress plugin that enhances the WordPress media manager by adding a folder manager inside.




Main advantages:

  • Multi-level folders
  • Move media with drag'n drop controls
  • Multiple media selection and move
  • Create galleries from folders
  • 4 gallery themes
  • NextGEN gallery importer
  • Import post categories as a folder
  • Breadcrumb and folder tree navigation
  • Bulk upload in a particular folder
  • Nothing lost on uninstall
  • WooCommerce support



1.1 Install

In order to install our plugin you should use the standard WordPress installer or unzip and put the whole folder in /wp-content/plugin.




Then click on activate plugin to see WP Media Folder menu appear on the WordPress left menu.

WP Media Folder is accessible from the media menu and the media button above your editor. You also have the parameters under the "Settings" menu.

1.2 Update the plugin

In order to update the WP Media Folder, you can use the WordPress default updater. You can also remove and install the new version from a .zip file downloaded from www.joomunited.com. In any case you won’t lose any content because everything is stored in a database.



Be sure to always have the latest version to avoid security and stability problems.

To update the paid version, you need to login to your JoomUnited account from the WordPress settings: Settings > General




Then use your JoomUnited account login and password. After a successful login the button turns to blue with a text Disconnect my JoomUnited account.




Finally, you can update all the JoomUnited commercial plugins from the WordPress standard updater.




1.3 Notifications after installation

After installing the plugin you will get 2 notifications

  • Do you want to import the post categories as media folders?
  • Do you want to import NextGEN galleries as media folders?

Hit Yes to proceed or Dismiss to ignore.


The main idea of WP Media Folder is to classify media directly from the media manager. WP Media Folder works on the native media manager, both from the public and admin side. For example you can use it in posts and pages.

2.1 Manage folders from posts or pages

To use WP Media Folder just click on the Add Media button. 




Click on it to open the main media view with the folder management.




There's a button to create a folder and directories are listed below. When you click on Create folder you have to type a name and validate the creation.




If you want to create a sub-folder you just need to enter in a folder and repeat the operation. You can then use the breadcrumb or folder tree so not to lose yourself in folder levels :)




A single media can belong to several folders. When you click on a file look for the Media Folders selection setting in the the right side column and click on it.




You can also use the WordPress media manager to batch apply multiple folders to multiple media. First, click Bulk Select, pick media files and then press the Media folders selection button.




2.2 Manage media

In order to move one or several media in a folder, click on the media and drag it into the folder you want. 




You also have the possibility to drag multiple images into folders or into the folder tree. First select media.




Then drag media into folders.




A notification will then be displayed with the possibility to UNDO the last media move you've just made.




2.3 Remove and edit folders

The folder can be renamed by double clicking on the folder on the left panel or right clicking on the folder and choose Edit Folder.




In order to remove media, right click on the folder and click Delete button.




If you remove a folder with media inside, by default all media inside will go back the root of the media manager.

You also have a parameter to remove folder and the media inside the folder - use with caution!




You can also change the color of folder from the Change color menu.




2.4 Media view

The media and folders can also be managed from the WordPress media manager view.




You'll also see existing folders from the media view. Note that article categories are automatically added as folder.

To upload media in particular folders, select one and click on Add media. From the folder tree you can ensure that you're in the right folder.




In order to filter media, you can click Sorting / Filtering button. Media can be arranged by media type, category, dates, minimum and maximum size (in px), weight ranges.




2.5 WordPress media searching and filtering

WP Media Folder adds some new features to the default media manager. You'll find all the settings in the plugin configuration General > Media Filtering. You can use default ones, remove some filters and add you own.




From the configuration you can setup the weight and size filters ranges.




The sorting dropdown lists can sort images and folders based on:

  • File type (image, zip, pdf...)
  • Media upload date
  • Size (in pixels)
  • Weight
  • Sort folder (ID, Name, Custom order)
  • Sort media (Date, Title, Size, File type, Custom order)




Note: when you apply an ordering it will be automatically saved in your session using cookies. It means that next time you'll open your media manager, the media ordering will remain the same. 

2.6 Add remote Youtube video

In order to add a Youtube video, you can click the Add New button or Media icon as the image below.




Next, a text box will be displayed on the screen where you can paste the YouTube link. Then you will see a YouTube file among your media.




Note that: Our plugin supports to add Vimeo and Dailymotion video also.


2.7 Folder cover

This feature is valid when you choose Classic in Main Settings > Folder Design option.




After clicking on an image, you will see the Folder cover check box. Next you just tick that option and then the folder will be wrapped by that image.





WordPress has a native inbuilt gallery function. We've chosen to offer a enhancement of this feature based on the folders. You will be able to create galleries from folders or from a selection of images. Please go to 3.6 Gallery block in Gutenberg if you are using Gutenberg editor.




If you open a folder or select an image you will see a button called Create a gallery from folder. Once your gallery is created you have several new options in addition to the WordPress default ones such as:

  • Gallery theme: layout for the gallery
  • Columns: a number of columns for theme
  • Gallery image thumbnail size: a choice from WordPress default image resizing
  • Gallery image lightbox (large) size
  • The action on click on an image: open a lightbox, load a separated page, do nothing or link to custom link (a link can also be chosen by clicking on a single image)


  • Auto insert image: when you add an image in this folder, it can be automatically added to the gallery
  • Order by: you can order images by date, title, custom or random
  • Order: Ascending, Descending

If you experience bad quality images in case of a big thumbnail display, for example a big width gallery on 2 columns, we recommend that you load medium or large image.




The default gallery will override the WordPress default gallery theme. If your theme already has a styling option for the WordPress gallery, you can disable this feature.

- In order to use Gallery shortcode, you should go to Settings > WP Media Folder > Wordpress Gallery > Shortcode tab. After selecting the options, you can see the shortcode at the bottom page.




Here is the sample shortcode:

[gallery wpmf_autoinsert="1" wpmf_folder_id="8" display="default" columns="3" size="medium" targetsize="large" link="file" wpmf_orderby="post__in" wpmf_order="ASC" gutterwidth="10" border_style="solid" img_border_radius="10" border_width="1" border_color="#dd3333" img_shadow="1px 1px 10px 2px #cecece" autoplay="1"]

- Attributes:

+ 'wpmf_autoinsert': 1,
+ 'wpmf_folder_id': ID of folder,
+ 'display': default || slider || portfolio || masonry,
+ 'columns': 1 -> 9,
+ 'size': size of image,
+ 'targetsize': size of lightbox image,
+ 'link': file || post || none || custom, // use 'file' if want show lightbox when click image
+ 'wpmf_orderby': post__in || rand || title || date,
+ 'wpmf_order': ASC || DESC,
+ 'gutterwidth': padding betwene images (px),
+ 'border_style': solid || dotted || dashed, ....
+ img_border_radius (px), border_width (px), border_color,
+ img_shadow: shadow includes H offset, V offset, blur, spread (px) and color,
+ 'autoplay': 1 || 0 // autoplay slider

You can define custom links per image in the gallery, which can be very useful if you need to create a homepage layout based on a gallery that redirects to pages or posts.

While editing galleries, click on an image and look at the right column options.




You can define an internal or external link to this image using the WordPress default link manager. You will also be able to define the target where the link will open as the same window, or a new window (new tab).




The first gallery option is the theme choice.  The default theme is an enhancement of the WordPress default theme, bringing you lightboxes to images.




Masonry will display a wall of images with fixed width and fluid height.




Portfolio theme is a stylish gallery with hover effects, titles and captions.




The slider theme is a horizontal slider with title and captions.




3.4 Image options

Each image has some options in a gallery. Click on an image to see them.

  • Title and caption can be displayed in the gallery depending of the theme you've chosen
  • Link to allow you to add, for example, lightboxes to images or add custom links to individual images in a gallery - the WordPress link manager will help you to do that
  • Link target can define if the link will be loaded in the same window or in a new one

In each gallery you can order your images by:

  • Custom order
  • Random order
  • Title
  • Date

WP Media Folder has a NextGEN gallery importer. Once the plugin is installed, WP Media Folder will detect the NextGEN gallery installation and you'll get a notice to import galleries.

Each gallery will be imported as a single folder with the name of the gallery as the folder name.




You can show your galleries in Gutenberg editor now.

In order to display a gallery in Gutenberg editor, clicking on the WP Media Folder Gallery button in the WP Media Folder category. After that, you can select the folder from your Media, then clicking on the Create Gallery button. Besides, you can make your own gallery by selecting images from your Media Library or upload directly from your PC.




And then, you can edit the gallery by clicking on the Edit Gallery button on the top or add more images by clicking on Upload an image button at the bottom.

All the gallery settings are on the right panel.




3.7 PDF Embed in Gutenberg

There is an option to embed a PDF file when inserted in Classic Editor. Now you can do in Gutenberg editor also.

First, you click on the WP Media Folder PDF Embed button in the WP Media Folder category. Then you press Add PDF button to embed a PDF file. After that, you can edit by hitting the Edit PDF button.





Global settings are available through the menu Settings > WP Media Folder > General > Main Settings tab.




4.1 General settings

  • Folder Design: Select the design of the folder listing: material design with color (by default) or classic, the legacy design with folder covers
  • Activate WP Media Folder on frontend: If you're using a page builder that is available on the frontend, you can activate this option to use WP Media folder. If not, keep it disabled - you'll get better performance without it
  • Folder tree: Load a left folder tree on the left part of the media manager for a faster folder navigation
  • Enable remote video feature: Include and manage remote video from Youtube Vimeo or Dailymotion
  • Media count: Display the number of media available in each folder in the folder tree
  • Search through all media folders: The media search engine (in the media manager) can search in the whole library or only on the current folder (default parameter)
  • Override file: Replace an existing file with another without generating broken links (same format allowed, for example from .jpg to .jpg)
  • Duplicate file: Add a button to duplicate a media from the media manager
  • Hover image: On mouse hover on an image, a large preview is displayed
  • Enable the filter and order feature: Additional filters will be added in the media views
  • Load GIF file on page load: Automatically play the GIF animation on page load. By default it’s a static image in WordPress
  • Remove a folder with its media: When you remove a folder all medias inside will also be removed if this option is activated. Use with caution
  • Delete all data on uninstall (including addons): all your media files will be removed when uninstalling our plugin.
  • Display folder ID: Display and copy the folder ID by making a right click on the folder


Replace image and media in your content form the media library


  • Duplicate file: Duplicate a media file




  • Hover image: Display a hover effect that displays the image in a medium size on mouse hover in the administration panel




  • Filter and order feature: Order and filter media activation




  • Display folder ID: Display and copy the folder ID by making a right click on the folder




  • Media size filter and weigh filters: Add, remove or define filtering range




You can go to Settings > WP Media Folder > Wordpress Gallery > Gallery Features tab

  • Enable the gallery feature: Enable or disable gallery functions (create gallery by folder, gallery themes...)
  • Lightbox in galleries: Add a lightbox to images in WordPress default galleries
  • Enable the single image lightbox feature: Add a lightbox option on each image of your WordPress content
  • Caption on lightbox: Use caption of images on lightbox instead title




Gallery image size and settings: Choose which image sizes will be available to be chosen in galleries. WordPress has 6 sizes of images defined by default in the media settings. Once you install new plugins, a new size can be added. For example WooCommerce is adding a custom size for its products. You can choose which size to load in the image galleries here.




Sync/import NextGEN galleries: Only displayed if the plugin is installed - import or make a new sync of the NextGEN galleries available on the website

4.3 Media access

You can go to Settings > WP Media Folder > Access & Design > Media Access tab.

WP Media Folder has an option to limit media display and management to the user's own media only. When a new user is created, a root media folder is generated for them, with their name and all their media inside. They can create subfolders inside. As an administrator you have an option to display or hide your own media right inside the media manager.

You can limit media access by:

  • User (a folder per user)
  • User role (a folder per user role)
  • Define a root folder where all your users media/folders will be created




4.4 Server file importer & sync

A tool is included to import a massive amount of media from a server folder in the native WordPress media manager from the plugin Settings > WP Media Folder > Server Import. 
Select a folder and/or subfolder, click on import, and it’s done! All the folder structure and media are now available in your native WordPress media manager.

It imports the folder structure and all media inside.




A sync tool is also available from the plugin settings named "Server Folder Sync". From there you can sync a folder from the server where your WordPress website is currently installed with a WP Media folder. 3 main settings are available: 

  • Synchronization methods: from server to WP Media Folder and vice versa
  • The folder source and the destination: local server folder to WP Media Folder directory
  • The sync delay: delay to run a sync between those folders

First, you select the folder synchronization options:




And it’s very flexible, select the server folder (the source) and the WP Media folder (the destination), the synchronization delay and you’re done! Of course you can do that with several folders (folder list is at the bottom).




Then just click Add and Save Changes button and wait for the next sync.

That's 2 way synchronization: the media synchronization can also be done in the other way, from WordPress media manager to an external folder. This is pretty useful to share media with another plugin or CMS that is using a folder outside the default WordPress one: “/uploads”.




Note: You should not import/sync files from the current upload folder. If not, you will create an infinite loop.
For example: "03" is the upload folder: "wp-content\uploads\2019\03"

4.5 Single file design

The WordPress media manager handles not only images, but also documents and other file formats (like PDF, zip files). We’ve included a function to add you design on files. You can define a button and font colors, and instead of a basic link to a PDF file, for example, you'll get a real download button.

In Classic Editor:




In Gutenberg Editor:




4.6 Media Rename

You have an option to automatically rename your media on upload, respecting a pattern you’ve defined, which is useful for SEO. 
You can find at WP Media Folder configuration > Rename & Watermark > Rename On Upload tab

Tag avaiable: {sitename} - {foldername} - {date} - {original name}
Note: # will be replaced by increasing numbers




Remove characters: 

  • Hyphen (-)
  • Tilde (~)
  • Period (.)
  • Hash/pound (#)
  • Plus (+)
  • All numbers (0-9)
  • Ampersand (@)
  • Round brackets (())
  • Square brackets ([])
  • Curly brackets ({})
  • Underscore (_)
  • Copy title to 'Alternative Text' Field? (-)
  • Copy title to 'Description' Field? (.)
  • Copy title to 'Caption' Field? (_)




Automatic capitalization: 

  • Capitalize All Words
  • Capitalize First Word Only
  • All Words Lower Case
  • All Words Upper Case
  • Don't Alter (title text isn't modified in any way)

4.7 Image watermark

You can apply image watermarks to your media - a non-removable watermark visible by your end-users.

First, you need to enable the Images watermark feature at WP Media Folder configuration > Rename & Watermark > Watermark tab.
Then select an image that you want to set as watermark. 
Next, you can set the adjust the scale of the image or set the margin for it.
After that, you can select which image sizes can be applied on and tick on the folders to exclude the watermark.
Finally, clicking the Thumbnail regeneration button and save the settings - all the images in your media library will be regenerated with a new watermark. 

4.8 Image Compression

ImageRecycle is a 3rd party image compression service: https://www.imagerecycle.com/

We've added the service in the left menu Settings > WP Media Folder > Image Compression because we consider it's a big performance improvement but it's not mandatory to use it. Our members can get a 20% OFF coupon on all membership from the configuration page.




After installing, you can compress the image and pdf files at left menu Media > ImageRecycle.




For more information you can go here: https://www.imagerecycle.com/cms/wordpress

4.9. WPML settings

If you are using WPML and want all your files and folders are translated into all languages, please navigate to WPML > Settings > Taxonomies Translation and then tick the buttons on Not translatable column of both WPMF Categories and WPMF Gallery Categories; or just WPMF Categories if you do not use Gallery Addon.




Note: Don't use WPMF Categories (wpmf-category) in the WPML > Taxonomy Translation. If you select the WPMF Categories, all your folders will be duplicated. Please take a look at the image below for more details.