Type to search.

#891 by installscommunity

The Icon Block

by Nick DiegoVersion 2.1.0

Easily add SVG icons and graphics to the WordPress block editor.

Active installs
40,000+
#891 of 1,000
Downloads, all time
385.1K
385,101
Downloads, 30 days
20.4K
6.3K in the last 7
Rating
5.0 / 5
29 reviews
Last updated
47 days ago
Sep 14, 2026
Version
2.1.0
20 releases

Upkeep and compatibility

Last updatedSeptember 14, 2026Updated in the last 3 months
Tested up toWordPress 7.1.4Covers WordPress 7.1.4, the current release
Needs WordPress6.6 or newer
Needs PHP7.4 or newer
First publishedSeptember 25, 2021
Support, last two months1 of 1 threads resolved (100%)

Reviews

5.0 / 5 from 29 reviews

Reviews by star rating
5 stars29
4 stars0
3 stars0
2 stars0
1 star0

Downloads, last 30 days

Low 189 a dayHigh 1.4K a day

What the author says it does

The Icon Block plugin registers a single, easy-to-use block that allows you to add custom SVG icons and graphics to the WordPress block editor (Gutenberg).

The plugin also includes the complete WordPress icon library with 290+ SVG icons.

Key features

  • 290+ native WordPress icons, including social logos
  • Use any custom SVG icon or graphic
  • Insert icons from your Media Library if SVG uploads are supported
  • Includes handy icon controls (link, rotate, alignment, colors, border, padding, margin, etc.)
  • Fully compatible with the Site Editor
  • No block library required 🎉
  • Built almost entirely with native WordPress components
  • Will get additional functionality as it’s added to WordPress core
  • Register your own custom icon library. Learn more

Stay connected

  • View on GitHub
  • Visit plugin project page
  • Follow on Twitter

The opening of the plugin's own description. The full text, installation notes and changelog are on its WordPress.org page.

Questions the author answers

Where can I get more icons?

Currently, the Icon Block only includes the WordPress icon library. That said, the plugin allows you to render any SVG-based icon by simply copying/pasting the code into the icon text area when using the “Add custom icon” option! See the screenshots for reference. This gives you complete flexibility and allows you to use practically any icon you want.

Why is my icon not changing color?

The Icon Block includes controls for the icon’s color and background. However, if your SVG icon has hard-coded color/fill values, the plugin will respect those instead of any applied custom colors.

Why can’t I add SVG icons from my Media Library?

By default, WordPress does not allow you to add SVG files to your Media Library, but you can enable this functionality using plugins like Safe SVG. If SVG uploads are enabled, you will see the option to insert icons from Media Library in the Icon Block.

Why is the block not working for certain users?

WordPress only allows Administrators and Editors to save “Unfiltered HTML” content, which includes SVGs. The Icon Block will not work properly for users who are at the Author level or lower.

Note that WordPress multisite installations have additional restrictions. “Unfiltered HTML” is restricted to Super Admins on multisite.

Latest changelog entry

2.1.0 – 2026-09-14

Changed

  • Updated “Tested up to” to WordPress 7.1.
  • Updated minimum WordPress version to 6.6.
  • Updated all npm dependencies, including @wordpress/scripts 35, and rebuilt the plugin with the current build tooling.

Fixed

  • Fixed all stylelint issues in the SCSS source. There are no visual changes.

Screenshots

First 4 of 6, from WordPress.org.

Tagged

Plugins that share its tags

#48 by installs

SVG Support

by Benbodhi

Securely upload SVG files to your media library, with built-in sanitization and advanced features for styling and animation.

Installs
1+ million
Rating
4.8 (356)
Updated
Today

#54 by installs

Safe SVG

by 10up

Enable SVG uploads and sanitize them to stop XML/SVG vulnerabilities in your WordPress website.

Installs
1+ million
Rating
4.9 (79)
Updated
5 days ago

#63 by installs

Spectra Legacy – Gutenberg Blocks

by Brainstorm Force

Gutenberg blocks for existing Spectra websites. Maintained, stable, and fully supported — no action needed on your part.

Installs
1+ million
Rating
4.7 (1.9K)
Updated
22 days ago

#80 by installs

Breadcrumb NavXT

by John Havlik

Adds breadcrumb navigation showing the visitor's path to their current location.

Installs
800,000+
Rating
4.6 (132)
Updated
2 months ago

#141 by installs

Font Awesome

by fontawesome

The official way to use Font Awesome Free or Pro icons on your WordPress site, brought to you by the Font Awesome team.

Installs
400,000+
Rating
3.6 (61)
Updated
3 months ago

Where this page's numbers come from

Read from the WordPress.org plugin API on , when WordPress 7.1.4 was the current release. WordPress.org rounds active installs into buckets. These are the directory's figures, not my verdict, and I haven't tested this plugin.