Aculect Icon Library

Description

Aculect Icon Library is a WordPress plugin that adds Heroicons, Bootstrap Icons,
Font Awesome Free, Tabler Icons, Radix Icons, Rune Icons, Google Material Icons,
a compatible Iconoir Solid subset, Phosphor Icons, Ionicons, and custom SVG icons to the native WordPress
Icon block. Choose bundled libraries from Appearance > Icons > Install Library, enable the styles you need in Library,
and select icons in the WordPress block editor.

Choose bundled libraries from Appearance > Icons > Install Library and enable them in Library. The 1.2.0 package includes all ten supported icon families and their
license and exclusion notices. Existing sites retain their bundled libraries,
preferences and saved icon names through an ordinary plugin update. No bridge
package or separate preservation stage is required. Remote discovery, preview,
and downloaded-library installation are not part of this release.

Bundled icon libraries

  • Heroicons: Outline and Solid.
  • Bootstrap Icons: Default and Filled.
  • Font Awesome Free: Solid, Regular, and Brands.
  • Tabler Icons: Filled.
  • Radix Icons: Default.
  • Google Material Icons: Filled 24px, Core-compatible subset (1,038 icons).
  • Iconoir: Solid, compatible filled-path subset (210 icons).
  • Phosphor Icons: Regular and Fill (2,487 icons).
  • Ionicons: compatible Filled, Sharp, Outline, and Brands subset (679 icons).
  • Rune Icons: Pixelated (215 icons).

Preview bundled icons by library, variant, and category before choosing a library. Search and filter selected bundled icons where
available, and load more results as you browse. Enable or disable individual
variants as needed.

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).
  • Tabler Icons: https://github.com/tabler/tabler-icons (MIT license).
  • Radix Icons: https://github.com/radix-ui/icons (MIT license).
  • Rune Icons, pixelated variant only: https://github.com/Nexvyn/runeicons (Apache-2.0; bundled license and SVG modification notices).
  • Google Material Icons, compatible filled 24px subset: https://github.com/google/material-design-icons (Apache-2.0; bundled license and modification notices).
  • Iconoir, compatible Solid subset: https://github.com/iconoir-icons/iconoir (MIT license; bundled license and exclusions).
  • Phosphor Icons, Regular and Fill: https://github.com/phosphor-icons/core (MIT license; bundled license and exclusions).
  • Ionicons, compatible style subset: https://github.com/ionic-team/ionicons (MIT license; bundled license and exclusions; brand marks remain their owners’ trademarks).

Screenshots

Installation

  1. Upload the plugin to the wp-content/plugins/aculect-icon-library directory.
  2. Activate Aculect Icon Library in WordPress.
  3. Open Appearance > Icons > Install Library and choose a bundled library. Then enable it in Library.
  4. Open a post or page in the block editor, insert the Icon block, and select an icon from the enabled library. Adjust its sizing and styling, then save.

FAQ

Which icon libraries are included?

Heroicons includes Outline and Solid. Bootstrap Icons includes Default and
Filled. Font Awesome Free includes Solid, Regular, and Brands; Pro-only styles
are not included. Tabler Icons includes 1,012 Filled icons after excluding its
Brand category and selected trademark or character references. Radix Icons
includes its non-logo 15-pixel icon collection. Google Material Icons includes
a Core-compatible Filled 24px subset. Iconoir includes 210 compatible Solid
icons; Regular and mixed-stroke icons are deferred. Rune Icons includes 215
pixelated icons. Phosphor Icons includes Regular and Fill. Ionicons includes
compatible Filled, Sharp, Outline, and Brands icons; unsupported assets are
recorded in the bundled exclusion report. Libraries are disabled by default.

How do I add an icon to a WordPress post or page?

Enable a bundled library or variant from Appearance > Icons, then insert the
native Icon block in the block editor. Choose an icon from an enabled library
and use the block’s sizing and styling controls.

Does this add a custom icon block?

No. Aculect Icon Library integrates with the native WordPress core/icon block.

Can administrators add custom SVG icons?

Yes. Administrators can add SVG files through Appearance > Icons > Upload.
SVG files must be no larger than 64 KB and use supported SVG geometry.
Unsupported features can cause an upload to be rejected; arbitrary SVG files
are not supported. Use flattened paths with explicit fills for complex exports.

Does this enable SVG uploads in the Media Library?

No. Custom SVG icons are validated and stored separately by Aculect Icon Library.
The plugin does not enable general SVG uploads in the WordPress Media Library.

Are icons hosted locally?

Yes. Included library SVGs and uploaded custom icons are stored on your site.
No external service connection is required to browse or use them.

Can I enable or disable individual icon styles?

Yes. Open a library’s detail screen to enable or disable its variants, such as
Solid or Outline. Disabled variants stop appearing for new selections.

What happens when I disable a bundled library or variant?

Its icons stop appearing for new selections. Existing saved Icon blocks can
still resolve those icons while Aculect Icon Library remains active and its
bundled SVG files remain available. This also applies to disabled variants.

What happens when I delete a custom icon?

Deleting a custom icon permanently removes its stored SVG and metadata.
Existing blocks that reference it can no longer resolve that icon. Replace
those icons in your content before deleting them. Renaming a display label
does not change the icon’s registered name.

What happens when I deactivate or uninstall the plugin?

The Icon block stores the registered icon name rather than an SVG copy. Existing
post content remains, but plugin-provided icons cannot resolve while the plugin
is inactive. Uninstalling also removes plugin settings, custom icon files, and
custom icon metadata. Back up custom icons before uninstalling.

Can AI agents manage icons?

Compatible agents and tools can use the WordPress Abilities API to search enabled
icons and list, insert, replace, or remove native Icon blocks. The plugin does
not include an AI assistant. Read actions require editor-style access; post
actions require permission to edit the target post. Ability inputs do not accept
raw SVG, filesystem paths, arbitrary block markup, or post content.

What are the requirements?

Aculect Icon Library requires WordPress 7.1 or later and PHP 7.4 or later.
It integrates with the native WordPress Icon block, not a page-builder-specific
icon widget.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Aculect Icon Library” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Aculect Icon Library” into your language.

Interested in development?

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

Changelog

1.2.0

  • Added support for Phosphor Icons (Regular and Fill).
  • Added support for Ionicons (compatible Filled, Sharp, Outline, and Brands subset).
  • Added support for Iconoir (compatible Solid subset).
  • Added support for Rune Icons (Pixelated).
  • Added support for Google Material Icons (compatible Filled 24px subset).
  • Add Install Library to choose from ten bundled icon families, then enable their styles in Library. Removing a library preserves saved icons.
  • Reduce icon picker loading and load custom icon previews one page at a time.
  • Protect library settings and custom icons during concurrent changes, and prevent uploads from replacing archived artwork.
  • Prevent automated post edits from overwriting newer changes.
  • Improve keyboard focus during icon picker pagination and upload retries, and close upload dialogs when switching tabs.
  • Show clearer upload and listing errors and retain existing results when a refresh fails.

1.1.0

  • Added support for Tabler Icons.
  • Added support for Radix Icons.
  • Preserve upstream categories, searchable metadata, licenses, and source revisions for both libraries.
  • Add deterministic importers and exclusion reports without weakening the WordPress Icon API SVG contract.

1.0.1

  • Add a WordPress.org Playground preview Blueprint that installs the latest stable package and creates an Icon block demo.
  • Validate the preview package source and fail clearly when the demo page cannot be created.
  • Extend PHPCS coverage so shell_exec() usage must remain explicitly reviewed. Props Alkesh Miyani (@alkesh7).
  • Document the reasoning behind security, filesystem, permissions, and concurrency safeguards. Props Alkesh Miyani (@alkesh7).
  • Strengthen release-package validation and release documentation for the 1.0.1 candidate.

1.0.0

  • Integrate collections with the WordPress 7.1 public Icon API.
  • Bundle 648 Heroicons Outline and Solid icons, 2,073 Bootstrap Icons, and 2,883 Font Awesome Free style entries with the upstream 68-category taxonomy plus a Brands grouping, separately categorized variants, and deterministic manifests. Outline is opt-in while its WordPress 7.1 Core sanitization workaround is validated.
  • Expose available styles separately in the native Icon picker collection filter.
  • Add per-variant enable and disable controls with capability-checked REST routes.
  • Add Appearance > Icons library management and searchable previews.
  • Add strict local custom SVG icon management.
  • Preserve saved icons when bundled libraries are disabled.
  • Add reproducible validation and release packaging.
  • Add permissioned WordPress Abilities API actions for icon discovery and core/icon block editing.