Download List with Icons


This plugin provides a Gutenberg Block to manage a download list with file type specific icons. No configuration is necessary. The Block can be used immediately after installation.


  • Choose files from media library
  • Output chosen files as list with file-type-specific icon, download-link, title, size and description from media library
  • Ships with multiple iconsets (Bootstrap-Icons, Dashicons, FontAweSome-Icons)
  • Drag & Drop sorting for the list
  • Remove files from list


  • Display of file size, description and icon can be switched on and off
  • Choose what link should be published: direct link or attachment page
  • Choose an iconset for each Block; manage custom icons in unlimited lists
  • Usage of multiple hooks to change or add icons to generated iconsets
  • Sort list by title or filesize with one click
  • The Block can be used in classic widgets
  • Set colors, typography and borders for each Block
  • Use External files in media library if you want to link to external files

The development repository is on GitHub.


  • After adding the Block you have to choose the files.
  • After adding files to the Block they will be listed.
  • The files will be listed in frontend.


Deze plugin voorziet 1 blok.

  • Download List Block with Icons Provides a Gutenberg block for capturing a download list with file type specific icons.


  1. Upload “download-list-block-with-icons” to the “/wp-content/plugins/” directory.
  2. Activate the plugin through the “Plugins” menu in WordPress.
  3. Add the Download List Block to the post or page where you want to show the downloadlist. Choose the file(s) you wish to present.


Where do I enter the description of a file?

The description stored at the file in the Media Library itself is used as the description. You can edit it in 2 ways:

  • Open the file in the Media Library for editing. There you will find the field “Description”. Enter the desired description here.
  • Or open this editing mask via the pencil at the file in the block you have created.

Is there a limit to the number of files?

No, there are no limitations.

Can I use the block in my theme?

The block can basically be used in any theme that supports Gutenberg blocks. If this is the case for your theme, you have to ask your theme developer.

Can I add my own icons?

Yes, you can manage your custom iconsets in WordPress-backend.

No icon is displayed at a file. Why?

The file will probably have a file type that does not comply with the WordPress standard and is therefore not included in our plugin. You have 2 options:

  • Use the iconset specific hook downloadlist_*_icons to add the list of icons. Check beforehand with the developer of your chosen icon set if the icon you want is included there.
  • Use another icon set which supports the file type if necessary.

Does the plugin also support Elementor or other PageBuilders?

No. The plugin is intended solely for the Gutenberg editor and will not be extended to other PageBuilders.


12 april 2023 3 reacties
This Gutenberg block plugin makes it very easy to add a list of downloads anywhere on the page. You can select the files from the media manager and choose whether to show the description, size, etc. And they can be bullets or numbered. My page builder often conflicts with 3rd party blocks, but this one worked perfectly. It looks very elegant, and it will be easy for my clients to use. Originally I had a conflict, but support fixed it immediately - very responsive development team!
20 juli 2023 1 reactie
I was looking for a plugin that would allow me to show the size of the files I wanted to share with the community as well as the extension and icons to show for each individual file. With this plugin I found everything. Good integration with Gutenberg. This plugin replaces Gutenberg's insufficient native "file block" and extends its capabilities. Please, increase the possibility to select file's icons
19 oktober 2022
This plugin is even better than the built-in single download link block since it takes its link text from the media title instead of the media filename. Thank you, Thomas!
26 juli 2022 3 reacties
Interestingly this block doesn't display anything if placed inside another block (I tried Kadence rows and sections, a Gutenberg column and a Stackable column). Could be very useful if this bug is fixed. No settings to hide/show display elements but easy to do with CSS. EDIT: the issue with nested blocks was fixed, and other options like hiding file sizes and hiding icons were added. This is now a solid choice for creating a simple download list.
Lees alle 4 beoordelingen

Bijdragers & ontwikkelaars

“Download List with Icons” is open source software. De volgende personen hebben bijgedragen aan deze plugin.


“Download List with Icons” is vertaald in 4 talen. Dank voor de vertalers voor hun bijdragen.

Vertaal “Download List with Icons” naar jouw taal.

Interesse in ontwikkeling?

Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.



  • Initial commit


  • Fixed issue with 3rd-party dependency
  • Updated format for Changelog


  • Updated dependencies


  • Updated dependencies


  • Updated compatibility-flag for WordPress 6.0


  • replace serialize_block in favor of render_block for better compatibility with other blocks


  • Add support for inner blocks
  • Fixed usage of foreign shortcodes
  • changed used sortable-library


  • Added option to edit each file in a Block in media library with one click
  • Added control-option to show or hide the filesize of all files in a Block (default: show)
  • Added control-option to show or hide the description of all files in a Block (default: show)
  • Added control-option to show or hide the icon of all files in a Block (default: show)
  • Added toolbar-option to sort the files in a Block by their titles with one click
  • Added toolbar-option to sort the files in a Block by their filesize with one click
  • Added control-option to set the link target for all files in a Block to
    “direct link” (e.g. /wp-content/uploads/file.pdf) or “attachment page” (e.g. /file/)
  • Added support for HTML-output in file description
  • Added support for using this Block as Widget
  • Changed loading of file-data in Block in Gutenberg: they are now loaded live from Media Library as the front page
  • Fixed icon-visibility (only default icon was visible)
  • Updated compatibility-flag for WordPress 6.0.1


  • Fixed release-upload problem


  • Fixed widget-handling: all other widgets were not visible


  • Fixed limit of entries per list – it’s now unlimited


  • Add some german translations
  • Updated compatibility-flag for WordPress 6.1


  • Added support for templates via theme
  • Updated dependencies
  • Updated compatibility-flag for WordPress 6.2


  • Fixed output of classic block if this plugin is used


  • Added possibility to manage different iconsets and assign them to each Block
  • Added styling (e.g. color, typography ..) for Blocks using WordPress-standards
  • Compatible with WordPress Coding Standards
  • Minimum PHP-compatibility set to 8.0
  • Only compatible with WordPress 6.0 or newer
  • Compatibility with WordPress 6.3
  • Compatible with theme Blockify and much more FSE-themes


  • Fixed initialization of iconsets during plugin activation


  • Added option to disable forcing download on click on file-link
  • Added option to show download-button on each file entry
  • Optimized styling for files with description
  • Optimized iconset-style-generation
  • Fixed usage of unique function names


  • Added custom title and description for files in downloadlist
  • Added icon for our own icon-post-type in wp-admin
  • Optimized rest of code regarding WordPress Coding Standard
  • Updated dependencies