Aculect Icon Library is a WordPress plugin that adds Heroicons, Bootstrap Icons,
Font Awesome Free, and custom SVG icons to the native WordPress Icon block.
Manage libraries from Appearance > Icons, enable the styles you need, and
select icons in the WordPress block editor.
Manage everything from Appearance > Icons. No icon libraries are installed by
default: open Install Library to browse the included libraries and install
the ones you want to use.
Heroicons, Bootstrap Icons, and Font Awesome Free
- Heroicons: Outline and Solid.
- Bootstrap Icons: Default and Filled.
- Font Awesome Free: Solid, Regular, and Brands.
Preview icons before installing a library. Search and filter by library,
variant, and category where available, and load more results as you browse.
Enable or disable individual variants and uninstall libraries you no longer
need.
Upload and manage custom SVG icons
Upload custom SVG files through the Upload tab, give them recognizable labels,
and use them alongside library icons in the native Icon block. Rename labels
or delete custom icons from the uploaded icons list.
SVG uploads are validated before storage and are limited to supported SVG
elements and attributes. Custom icons are managed by the plugin and do not
enable SVG uploads in the WordPress Media Library.
Use icons in the WordPress block editor
Enabled icons appear in the existing Icon block picker, where you can use the
block’s own sizing and styling controls. Aculect Icon Library extends this
workflow without adding a separate icon block or using icon fonts.
Included libraries and uploaded icons are stored locally. No external service
connection is required to browse or use them.
Icon automation with the WordPress Abilities API
The WordPress Abilities API integration lets compatible AI agents and tools
search enabled icons and insert, replace, or remove Icon blocks. Actions respect
WordPress permissions, including permission to edit the target post.
Requires WordPress 7.1 or later and PHP 7.4 or later.
Source code
Source and build tools: https://github.com/mehul0810/aculect-icon-library
The editable DataViews source is assets/src/custom-icons-dataviews.js.
To rebuild assets/build/custom-icons-dataviews.js, run npm ci followed by
npm run build from the repository root. Dependencies and their exact versions
are recorded in package.json and package-lock.json.
Third-party licenses
Bundled libraries remain under their upstream terms:
- Heroicons: https://github.com/tailwindlabs/heroicons (MIT license).
- Bootstrap Icons: https://github.com/twbs/icons (MIT license).
- Font Awesome Free: https://fontawesome.com/license/free (Font Awesome Free license).
Screenshots
View installed icon libraries and their active variants from Appearance > Icons.
Browse Heroicons, Bootstrap Icons, and Font Awesome Free in the Install Library tab.
Upload custom SVG icons, search uploaded icons, rename labels, and delete icons.