This is the official Icon List Block documentation. It shows you how to replace plain bullet points with icons and build lists that are easier to scan.
Getting Started takes you through installation, onboarding, and license activation. How To Use covers icons, links, themes, and every styling option, then shows how to display a list anywhere with a shortcode. See the FAQs for quick answers.
Icon List Block replaces plain bullets with icons, so feature lists, steps, and key points stand out on the page.
Each list item has its own icon, text, and optional link. You can use font icons or upload your own, pick one of seven themes, and style the header, list items, background, border, and shadow.
Use it for product features, benefits, step-by-step guides, or service lists. Icon List Block Pro adds 8+ extra list blocks, including Terminal List, FAQ Accordion, Magazine List, and Zigzag List.
Before installing Icon List Block, make sure you have:
There are three ways to install Icon List Block. Use whichever is most convenient.
Install the plugin directly from the WordPress plugin directory.
After installation, click Activate to enable Icon List Block.
Upload icon-list-block.zip if you would rather install it from a file.
Install it from the block inserter while you are editing a page.
Right after you activate Icon List Block for the first time, a guided setup screen opens.
Click Allow & Continue to subscribe to our newsletter and get the latest plugin updates and news.
The setup then redirects you to the plugin dashboard.
If you bought Icon List Block Pro, activate your license to unlock the extra list blocks.
Go to Plugins » Icon List Block » Active License.
Next, visit How To Use to build your first icon list.
You can easily build an icon list with the Icon List Block.
Add icons, text, and links in a few clicks, then adjust the layout, spacing, and styles to match the list to the rest of your site.
You can find Icon List Block in the block library and add it to any section of your page.
The block arrives with a default theme that you can edit right away.
Select the block, and its settings open in the sidebar on the right.
You can choose from several icon types, including font icons and custom images. To use your own icon, upload it as a custom icon.
You can give each list item its own link, pointing to any page, section, or external website.
You can add a new list item with its icon and text in one click. Remove items you no longer need, or duplicate an existing item to create a similar one faster.
You can choose from 7 themes to change the look of your icon list in one click.
Turn this option on to open list item links in a new browser tab, so visitors stay on the current page.
Turn this option on to show a link icon next to each list item that has a URL.
You can set the overall width of the icon list to fit your layout, and give it a background color or gradient.
You can adjust the space inside the icon list to give it a clean, balanced look.
You can add a border around the icon list or around individual items, and set its style, width, and color.
You can add a subtle or bold shadow to the icon list or its items to give them depth.
You can style the list header: show or hide the title and set its margins, typography, and color. You can also style the description text, and show, hide, or style the separator.
You can set each list item's icon, text, spacing, color, typography, and alignment.
When your icon list is ready, publish the page. The list goes live with all its styling.
The features in this section are available with Icon List Block Pro. Pro
You can choose from 7 themes: Default, Linked Badge, Smart Grid, Icon Badge, Pulse Grid Glow, Click Badge, and Orbit Grid. Select a theme from the Select Theme dropdown in the Themes panel to change the look of your list.
Icon List Block Pro also gives you 8+ extra list blocks, including Terminal List, FAQ Accordion, Magazine List, and Zigzag List. You can find them in the block library and add them to any section of your page.
You can display an icon list anywhere on your site with a shortcode.
Build the list once, then paste its shortcode into any page, post, or widget instead of rebuilding it each time.
Go to the dashboard menu and click Add New.
The block editor opens, where you can build and style the list. When you are happy with it, click Save.
Now go back to the dashboard menu, where the shortcode for your list is shown.
Click the shortcode button to copy it.
Paste the shortcode into any page, post, or widget area where you want the list to appear. Use the live preview to check how it looks before you publish.
Publish or save the page, then visit your site to see the result.
Icon List Block is a Gutenberg block that lets you use icons instead of bullets in your lists. You can use it for features, benefits, steps, services, and other list content.
Yes. Icon List Block is a free Gutenberg block plugin. The Pro version adds 8+ extra list blocks, including Terminal List, FAQ Accordion, Magazine List, and Zigzag List.
Yes. It works with any theme that supports the Gutenberg block editor.
Yes. You can add as many list items as you need and remove any you don't.
Yes. You can choose from seven themes: Default, Linked Badge, Smart Grid, Icon Badge, Pulse Grid Glow, Click Badge, and Orbit Grid.
Yes. You can change the icons, colors, typography, and other settings from the block sidebar.
Yes. You can add it as many times as you need across your pages and posts.
No. You can create and customize icon lists directly in the block editor without writing code.
Install and activate the plugin, add the Icon List block from the block library, add your list items, customize them from the sidebar, and publish your page.
You can post your questions on the support forum.