Download List Block with Icons


Use 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 shipped iconsets
  • Sort list by title or filesize with one click
  • The Block can be used in 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.


This plugin provides 1 block.

  • 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.

You can also add a custom title and description per file used only by the Block of this plugin.

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.


July 20, 2023 1 reply
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
April 12, 2023 3 replies
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!
October 19, 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!
July 26, 2022 3 replies
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.
Read all 5 reviews

Contributors & Developers

“Download List Block with Icons” is open source software. The following people have contributed to this plugin.


“Download List Block with Icons” has been translated into 4 locales. Thank you to the translators for their contributions.

Translate “Download List Block with Icons” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by 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


  • Compatible with WordPress Coding Standards 3.0
  • Prevented WPML from translating our (only internal used) custom post type and taxonomy for icons
  • Compatibility with WordPress 6.4
  • Updated dependencies
  • Fixed possible error during adding files


  • Changed text domain to plugin slug to match WordPress-Repository requirements
  • Removed language-files from plugin (except the json-files for Block Editor)
  • Added missing translations


  • Check if attachment page is enabled for WordPress 6.4 or newer before generating link to it
  • Updated dependencies
  • Some style-optimizations


  • Better check for uploads-directory existence for compatibility with playground-preview


  • Added possibility to convert File-, Audio- and Video-Block to Downloadlist-Block
  • Optimized sort-button: now sorting on every click in the opposite direction
  • Disable sort-buttons if list contains less or equal than 1 file
  • Releases now MUST fulfill all WordPress Coding Standard rules before creating release files
  • Removed AJAX requests for preview as list to request is empty for preview
  • Removed all language files from plugin directory
  • Updated dependencies


  • Fixed error in creating new Downloadlist-Block
  • Fixed typos in descriptions


  • Fixed loading of translation scripts


  • Added possibility to use multiple custom iconsets
  • Added automatic documentation of hooks in this plugin
  • Now generating valid class names from mime types (thanks @samedwards)
  • Rename handles of enqueued styles to prevent conflicts with other plugins
  • Compatibility with WordPress 6.4.3
  • Optimized style for editing custom icons
  • Optimized performance
  • Updated dependencies
  • Plugin now won’t be usable with PHP older than 8.0
  • Fixed missing translations
  • Fixed error on search for iconsets during editing your own icon
  • Fixed visibility of custom icons in backend
  • Fixed problem with duplicate entries for each iconset


  • Prevent uninstall with PHP older than 8.0 to prevent errors
  • Hide “Mine” in icon list in backend
  • Updated dependencies
  • Compatibility with WordPress 6.5
  • Fixed possible notice in transient-handler
  • Fixed removing of our own iconset taxonomy on uninstall


  • Optimized output of file size in list
  • Updated dependencies
  • Fixed choosing or uploading images button
  • Fixed generating of styles for custom iconsets


  • Added SEO-relevant rel-attribute to optionally prevent bots to follow download-links
  • Added new hook for rel-attribute
  • Compatibility with WordPress 6.5.3
  • Updated dependencies
  • Updated fontawesome and bootstrap icon libraries
  • Fixed potential PHP warning for files without sizes


  • Updated dependencies
  • Compatibility with WordPress 6.6
  • Fixed visibility of Dashicons in frontend if user is not logged in