Download List Block with Icons

Description

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.

Features

  • 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

Supports

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

Screenshots

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

Blocks

This plugin provides 1 block.

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

Installation

  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.

FAQ

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.

Reviews

Otoba 15, 2025
It’s very useful that it’s easy to use and compatible with Gutenberg. I searched everywhere and was starting to despair. So thank you to @threadi for this great work.I’ve suggested translations for the French version. I m waiting for their validation. I really need a French version for next month 🙂
Yuli 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
Aprailu 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!
Otoba 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!
Read all 7 reviews

Contributors & Developers

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

Contributors

“Download List Block with Icons” has been translated into 5 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.

Changelog

4.0.0

  • Added possibility to categorize media files in lists which could be used for listing of files in frontend
  • Added option to show file dates for each file
  • Added option to sort the list by file dates
  • Added option to show a label for the file format for each file
  • Added possibility to add custom font file for iconsets using unicode icons
  • Added new hooks
  • Added hint which page and view in backend is added or extended by this plugin
  • Added global settings for our block which can also be inherited to all blocks
  • Added task in settings to add the block to chosen pages or posts
  • Added option to reset the plugin in backend settings (in preparation for Cyber Resilience Act)
  • Using composer autoloader for each PHP-object for better performance
  • Using transient composer package for internal actions and admin notices
  • Updated dependencies
  • Fixed missing translations for bulk message editing of icons

older changes