This plugin easily displays the folders and files from a selected directory. It can be placed by shortcode with the parameters path and target in any post. Uploads must be done by a separate ftp program. No managing options.

  • compatible up to PHP7.2
  • need PHP extension mb_string

available optional shortcode parameters

  • path = directory path, starting by web root
  • target = browser window name
  • sort = ASC/DESC
  • label = custom top level label
  • nosize = displays no file size
  • hidedirs = displays no folders, only files
  • filetype = (comma separated list) filter files by their extension
  • hidefiletype = (comma separated list) hide files with filetype
  • hidefilename = (comma separated list) hide named files and folders
  • noext = hide the file extensions
  • nobreadcrumb = hide breadcrumb / title

shortcode examples

  1. displays content of wp-content/uploads/: [m1dll]
  2. displays content of your/foldername/here/: [m1dll path="your/foldername/here/"]
  3. displays content of your/foldername/here/ and sort descending: [m1dll path="your/foldername/here/" sort="DESC"]
  4. displays content of your/foldername/here/, open files in a new window: [m1dll path="your/foldername/here/" target="_blank"]
  5. displays content of your/foldername/here/, change label ‘downloads’ to ‘our downloads’: [m1dll path="your/foldername/here/" label="our downloads"]
  6. displays content of wp-content/uploads/, displays no file size: [m1dll nosize="1"]
  7. displays content of wp-content/uploads/, displays no folders: [m1dll hidedirs="1"]
  8. displays content of wp-content/uploads/, displays only pdf- and docx-documents: [m1dll filetype="pdf,docx"]
  9. displays content of wp-content/uploads/, do not display pdf- and docx-documents: [m1dll hidefiletype="pdf,docx"]
  10. displays content of wp-content/uploads/, do not display file secret.txt and secret.docx: [m1dll hidefilename="secret.txt,secret.docx"]
  11. displays content of wp-content/uploads/, displays no file extensions: [m1dll noext="1"]
  12. displays content of wp-content/uploads/, displays no breadcrumb: [m1dll nobreadcrumb="1"]


  • place the shortcode in your post
  • display the directory listing


  1. Upload the folder m1.downloadlist to your directory (wp-config/plugins/)
  2. Activate the Plugin
  3. place the shortcode in your post
  4. test and give us a review, thx! <3: https://wordpress.org/support/view/plugin-reviews/m1downloadlist


Can I manage files with “media” in WordPress?

No. Just upload your files and folders to an appreciate folder by FTP and link it by the shortcode [m1dll path="your/foldername/here/"].

I got problems with special characters in folders and/or filenames. How can I fix it?
  1. Check PHP version (suggested PHP7.0 or above).
  2. Check enabled PHP module mb_string is enabled.
  3. Check enabled UTF8 Apache Headers. (Ask your provider in doubt.)
  4. Check file permissions.


Displays files and directories

This is exactly what I was looking for. It can display files and directories, and has simple options to sort and do other functions. So many other file display plugins I looked at were either too complicated, couldn't sort (huh?), or couldn't display directories.

Perfect to add DL ability to WP!

This is exactly what I need to add the ability to share downloadable files with users on my wordpress site! Simple to add and works GREAT. Keep up the good work 🙂

show files, subfolders, subfiles, and so on

I previously used ListYoFiles plug in but it was cumbersome to use and a bit complicated. This plug in is absolutely great. It will not only show the files within a folder but it will show subfolders too. And if you click those subfolders it will show their files and any further subfolders and so on. It really is unbelievably simple and beautiful and gorgeous to use.
Read all 18 reviews

Contributors & Developers

“m1.DownloadList” is open source software. The following people have contributed to this plugin.


Translate “m1.DownloadList” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Change log


  • bugfix: removed debugging message


  • feature: new parameter ‘hidefiletype’
  • feature: new parameter ‘hidefilename’
  • bugfix: remove notice message for parameter “target” thx@rameshmehay
  • bugfix: show office documents icons (docx, xlsx, pptx)


  • bugfix: problems with subdirs


  • bugfix: notice message


  • feature: compatible up to PHP7.1
  • stability enhancements


  • bugfix: handling with UTF-8 filenames


  • feature: new parameter ‘nobreadcrumb’


  • bugfix: sort order


  • feature: new parameter ‘hidedirs’
  • feature: new parameter ‘filetype’; thx@noerw
  • feature: new parameter ‘noext’; thx@rwdrummond
  • bugfix: remove anoying PHP-notices / debugging-messages; thx@gonowjohn


  • feature: new parameter ‘label’
  • feature: new parameter ‘nosize’


  • feature: can handle more than 1 shortcode


  • feature: added localisation German & English (+ pot-file) hope someone help to translate it!


  • bugfix: display folder and file icons (thx to Lutz Müller)
  • feature: sort ascending and descending


  • bugfix: utf8_encode
  • bugfix: plugin path


  • initial release