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.

ویژگی ها

  • انتخاب فایل از کتابخانه رسانه
  • 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)
  • قابلیت درگ و دراپ برای لیست
  • حذف فایل از لیست


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

عکس‌های صفحه

  • بعد از افزودن بلاک ادیتور باید فایل ها را انتخاب کنید.
  • بعد از اضافه کردن فایل ها به بلاک ادیتور، لیست میشوند.
  • فایل ها در فرانت اند لیست میشوند.


این افزونه 1 بلوک ارائه می‌دهد.

  • 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. افزونه را از طریق فهرست “افزونه‌ها” در وردپرس فعال کنید.
  3. ویجت بلوک لیست دانلود را به پست یا صفحه ای که می خواهید لیست دانلود را نشان دهید اضافه کنید. فایل های مورد نظر برای نمایش را انتخاب کنید.

سوالات متداول

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.

نقد و بررسی‌ها

20 جولای 2023 1 پاسخ
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
12 آوریل 2023 3 پاسخ
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!
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!
26 جولای 2022 3 پاسخ
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.
خواندن تمامی 5 نقد و بررسی‌

توسعه دهندگان و همکاران

“Download List Block with Icons” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند.

مشارکت کنندگان

“Download List Block with Icons” به 4 زبان ترجمه شده است. با تشکر از مترجمین برای همکاری و کمک‌هایشان.

ترجمه “Download List Block with Icons” به زبان شما.

علاقه‌ مند به توسعه هستید؟

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

گزارش تغییرات


  • کامیت اولیه


  • Fixed issue with 3rd-party dependency
  • فرمت جدید لیست تغیییرات


  • 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