Icon Picker

Fixed

• Fixed the missing icon source service.

Fixed

• Fixed a low-severity cross-site scripting vulnerability.

Added

• Add Small, Default, and Large icon sizes and Hidden, Tooltip, and Below Icon label modes to field settings.
• Show headings between enabled icon sets, with optional subfolder headings for SVG Folder sets. (#124)

Changed

• Require Verbb Base 3.0.20 or later so shared control-panel layouts use the current asset bundle namespace. (verbb-base#3)

Fixed

• Allow Icon Picker fields rendered inside unsaved or nested elements, including Hyper links and Vizy Blocks, to load their configured icons without weakening saved-element permission checks. (#121)
• Prevent virtualized icon grids inside clipped containers, such as Hyper link cards, from rendering only part of the visible panel.
• Remove the extra vertical gap above Icon Picker field controls in Craft 5.

Fixed

• Avoid Verbb Base deprecation warnings by using its current control-panel asset bundle namespace. (verbb-base#3)

Changed

• Updated the required version of verbb/base to 3.0.19.

Added

• Built-in icon sets for Bootstrap Icons, Remix Icon, Material Design Icons, Phosphor, Lucide, Tabler Icons, Heroicons, and Octicons (CDN-backed catalogs — no icon files bundled in the plugin).
• Ionicons icon set (SVG from ionicons@8, outline / default / sharp variants). Legacy web-font set renamed Ionicons (Legacy).
• Optional Package version field on remote CSS/SVG icon sets (cdnVersion).
• Add field setting for optional input placeholder text when no icon is selected.
• Icon grid supports arrow-key navigation (Left/Right, Up/Down by row, Home/End).

Changed

• Field input rebuilt on Plugin Kit (web components).
• SVG icon catalogs and resource requests now use lightweight URLs and metadata instead of embedding full SVG markup, reducing cache and picker payloads while isolating SVG IDs and styles. Existing caches are superseded on next load. (#101, #103).
• Feather Icons no longer depend on remote feather.min.js / feather.replace(). Icon paths are bundled and cached as inline SVG for the CP. (#85).
• Feather Icons renamed to Feather Icons (Legacy) with CP notice to prefer Lucide.
• Update the bundled provider catalogs for css.gg 2.1.4, Bootstrap Icons 1.13.1, Remix Icon 4.9.1, Lucide 1.33.0, Tabler Icons 3.46.0, and Heroicons 2.2.0.
• Route plugin settings through the plugin’s authorized settings controller while keeping utility actions restricted to admin POST requests.
• Clarify field setup, remote SVG output, custom Icon Sets, configuration overrides, and Web Font requirements in the documentation.

Fixed

• Fixed a medium-severity resource exhaustion vulnerability.
• Fixed a low-severity information disclosure vulnerability.
• Fixed a cross-site scripting vulnerability.
• Preserve saved icon selections and previews when icon sets are renamed, disabled, deleted, or restricted to different collections, variants, or weights.
• Refresh icon catalogs, metadata, and resources when caches are regenerated or icon-set paths, URLs, handles, and project configuration change.
• Preserve Font Awesome style and collection selections, and load Kit resources and custom icons in element previews.
• Allow immediate retries after Font Awesome API failures, retain saved Kit previews during discovery outages, and respect the one-hour Kit cache duration.
• Keep SVG sprite collections distinct when symbols share names, and render nested references and gradients in field previews.
• Keep element previews usable when SVG spritesheets are empty or unavailable.
• Restore icon selection and insertion in Redactor fields, including correct handling of cleared selections and public sprite references.
• Import icons through Feed Me when a field uses all enabled icon sets.
• Validate icon-set names and unique handles, preserve their enabled state, fix reordering, and report deletions prevented by event handlers.
• Render mixed CSS icon sets with their own attributes and load each selected collection when multiple icon sets share a font name.
• Include the complete Material Design Icons catalog for the bundled font version.
• Render css.gg icons at the correct size and map the Vercel icon to its legacy stylesheet class.
• Load Material Icons fonts without glyph names and match fallback labels to the correct glyphs across font versions.
• Render custom fonts whose filenames contain spaces or punctuation.
• Render read-only fields without editable picker or Clear controls.
• Allow admins to regenerate caches and run diagnostics when admin changes are disabled.
• Fix false "leave page" warnings on icon set create/edit screens when no changes were made.
• Don’t open the icon pane on programmatic focus (Craft slideout setFocusWithin / focus restore). Open on click, Enter/Space/ArrowDown, or typing instead. (#109).
• Clarify Web Font support: glyph indexing requires .ttf / .woff / .otf (not .woff2 alone). Docs and icon-set UI updated; .woff2 is rejected with a clear error. (#107).
• Fix Icon::count() return type for Countable (int).

Fixed

• Fix the icon sets admin table after settings normalization.

Changed

• Normalize plugin settings.

Fixed

• Fix conflicting phenx/php-font-lib dependency (again).

Fixed

• Fix conflicting phenx/php-font-lib dependency when used alongside plugins that require dompdf v3 (e.g. Formie).

Fixed

• Fix Font Awesome “Brands” family.

Fixed

• Fix a z-index issue with the icon picker overlay.

Added

• Add GraphQL IconInterface.

Added

• Add recursive setting for SVG Icon Sets.

Changed

• Update SVG folder instruction text regarding recursive folders.

Changed

• Refactor Icon Picker field bootstrapping to DOM auto-mount.

Fixed

• Fix Font Awesome Sharp and Sharp Duotone styles for kits.

Fixed

• Fix visual issue for some icons and fill color.

Added

• Add troubleshooting and diagnostics utility.
• Add support for custom Font Awesome icons.

Changed

• Update English translations.
• Update Material Icons symbols.

Fixed

• Fix lack of handling for database column type for field.

Fixed

• Fix z-index issue with field, in combination with CKEditor, and the element slide-out editor.

Added

• Add extra error handling for Font Awesome kit icons.

Fixed

• Fix lack of required field validation.

Fixed

• Fix Font Awesome Brands style.

Added

• Add the ability to use Icon Picker’s icon in element thumnbails and cards.
• Add iconSetHandle to each chosen icon, to keep track of which Icon Set an icon belongs to.

Changed

• Automatic icon cache invalidation now only happens when devMode is enabled. To invalidate the cache, use the “Caches” utility and/or console commands.
• Update English translations.

Fixed

• Fix an error with Feed Me integration.

Changed

• Now requires PHP 8.2.0+.
• Now requires Craft 5.0.0+.

Fixed

• Fix conflicting phenx/php-font-lib dependency when used alongside plugins that require dompdf v3.

Fixed

• Fix Font Awesome “Brands” family.

Fixed

• Fix a z-index issue with the icon picker overlay.

Fixed

• Fix visual issue for some icons and fill color.

Changed

• Update English translations.

Added

• Add support for custom Font Awesome icons.

Fixed

• Fix lack of handling for database column type for field.

Fixed

• Fix lack of required field validation.

Changed

• Automatic icon cache invalidation now only happens when devMode is enabled. To invalidate the cache, use the “Caches” utility and/or console commands.
• Update English translations.

Added

• Add the ability to restrict Font Awesome kits by style.

Changed

• Update English translations.

Fixed

• Fix order of operations when uninstalling the plugin.

Added

• Add logging for Font Awesome kits.

Fixed

• Fix a PHP 8.2 warning.

Fixed

• Fix an error when using Icon Picker with Redactor.

Changed

• Hidden folders are now excluded from searches to find svg icons. (thanks @sfsmfc).

Added

• Add warning to field settings when no icon sets are available.

Changed

• Only admins are now allowed to access plugin settings.

Fixed

• Fix multiple Redactor fields with Icon Picker enabled not working.
• Fix icon sets cache not working correctly for multiple Font Awesome API keys.
• Fix Root default icon set not being created on install.
• Fix Icon Picker fields not working correctly in Redactor fields.

Fixed

• Fix SVG folder icon sets being mis-ordered when scrolling the icon picker dropdown.

Fixed

• Add back support for subfolders for SVG icon sets.
• Fix an error being thrown when the path to an SVG cannot be determined.

Fixed

• Fix an issue where Redactor-based Icon Picker fields weren’t being initialized.
• Fix remote icon sets (Font Awesome) not migrating properly.
• Fix not migrating fields in Matrix and Super Table properly.

Fixed

• Fix when migrating field content, not to wipe old values if invalid.
• Fix SVG icons not rendering correctly in some instances.

Fixed

• Fix lack of support for migrating remote icon sets.
• Fix a potential error when saving a new icon set.
• Fix an error when switching icon set type.

Fixed

• Fix an error when installing Icon Picker as a fresh plugin.

Fixed

• Fix some icon sets not migrating from previous plugin versions correctly.

Fixed

• Fix an error when migrating Matrix-based icons.

Fixed

• Fix a potential migration error where icon models haven't been migrated properly.

Fixed

• Fix a migration error when migration icon sets for already-applied project config.

Fixed

• Fix an error with incorrect Formie references included.

Fixed

• Fix some migration issues from 1.x.

Added

• Added the concept of Icon Sets to better organise collections of icons. This allows for greater flexibility, consistency and control for icons.
• Added the ability to register your own Icon Sets (even extend existing ones) for advanced handling of icons.
• Added better handling for rendering lots of icons.
• Added vue-virtual-scroller to improve render performance for large icon sets.
• Added icon set preloading for more performance benefits.
• Added Font Awesome 5/6 Free and Pro.
• Added Feather Icons.
• Added Ionicons.
• Added CSS.gg.
• Added Material Symbols.
• Add Feed Me support.
• Add plugin settings to configure the size of icons in the dropdown icon-picker.
• Add metadata.json file support for icon sets, to provide extra keywords for searching.

Changed

• Now requires PHP ^8.0.2.
• Now requires Craft ^4.0.0-beta.1.
• Now requires Icon Picker 1.1.12 in order to update from Craft 3.
• Migrate to Vue 3-based field input for more control and better client-side performance.
• Reorganise Icon and IconSet models, and improve server-side performance.
• Icon Picker will no longer automatically scan the nominated "Icons Path" for folders, sprites and fonts. Create an Icon Set instead.
• Revamp remote icon sets to be class-based, and treated like regular icon sets.
• Revamp Font Awesome remote set, add 5/6 Free and Pro CDN option, ability to select version/license/type/collections, and Kit option through API.
• Lazy-load non-SVG resources (fonts, spritesheets, scripts) for icon field values to save on-load performance hit.
• Change default path from icons to icon-picker to avoid some server setup conflicts.

Removed

• Removed Icon Sources and the concept of Remote Icons Sets. These are all now Icon Sets.
• Removed maxIconsShown plugin setting, as no longer required.
• Removed craft.iconPicker.getIcon().
• Removed craft.iconPicker.getDimensions().
• Removed craft.iconPicker.inline().
• Removed Icon::icon. Use Icon::value instead.
• Removed Icon::sprite. Use Icon::value instead.
• Removed Icon::css. Use Icon::value instead.
• Removed Icon::glyphId. Use Icon::getGlyph() instead.
• Removed Icon::glyphName. Use Icon::getGlyphName() instead.
• Removed Icon::getIconName(). Use Icon::label instead.
• Removed Icon::width and Icon::height.

Added

• Add icon-picker-svg and icon-picker-sprite classes to Redactor-chosen icons.
• Add support for multiple URLs for remote icon sets.

Fixed

• Fix sprite sheets getting incorrect id attributes.
• Fix an error when a field contained an icon from a remote icon set that no longer exists.

Fixed

• Fix JS Redactor plugin not installing correctly in some instances.

Fixed

• Fix Icons Path plugin setting not working correctly when using aliases.

Changed

• Update Font Awesome remote source to 5.15.1.

Fixed

• Ensure icons load in Super Table and other nesting fields.

Added

• Allow iconSetsPath settings to use environment variables or aliases.
• Allow iconSetsUrl settings to use environment variables or aliases.

Added

• Added iconPickerField.length and iconPickerField.getLength().
• Added iconPickerField.isEmpty and iconPickerField.getIsEmpty().

Fixed

• Fix error when only a single sprite existed in a sprite sheet.

Fixed

• Improve performance of remote icon sets. (thanks @bertoost).

Added

• Add enableCache setting.

Fixed

• Fix entry.iconField direct output showing URL, even when an icon isn’t picked.

Fixed

• Fix logging error Call to undefined method setFileLogging().

Changed

• File logging now checks if the overall Craft app uses file logging.
• Log files now only include GET and POST additional variables.

Fixed

• Fix windows path issues.
• Fix another potential error for field settings and icon sets.

Fixed

• Fix error with remote sets set to “All”.
• Fix error when installing for the first time.

Added

• Add GraphQL support for field. Now returns an IconModel.
• Add cache for each icon set. Icons for each set are now cached when the Icon Picker field is saved.
• Add controller action to lazy-load icon set content.
• Add utility to re-generate icon set caches.
• Improve performance for large icon sets.
• Add Redactor support. See docs.
• Add support for Google Material Design Icons, which need some special-handling.

Changed

• Major refactor, bringing performance improvements and caching.
• Update the icon selection field to lazy-load icons, rather than loading on page load. This brings significant performance benefits

Fixed

• Fix craft.iconPicker.spritesheet not always returning content.

Fixed

• Fix numerous errors when fetching remote icon sets via URL.
• Change Font Awesome icon source to use file-system fetching, rather than via HTTP.

Fixed

• Fix icons not propagating to other sites.

Added

• Add getPath() function to icon model.
• Add supported translation methods for field.

Changed

• Changing to Local file read from External URL.

Fixed

• Fix error when resolving font awesome json file path.
• Fix error when trying to access remote icons sets.
• Fix error with font-name for icon font files.

Fixed

• Fix Live Preview not showing icon selection.
• Fix Neo fields clipping icon selection.
• Icon selection pane now attaches itself to the field, instead of the body.

Added

• Add maxIconsShown to control how many icons should be shown in the selection pane.

Changed

• Update default iconSetsPath to be relative to the web folder - CRAFT_BASE_PATH . '/web/icons/'.

Fixed

• Fix compatibility with some sprite definitions.
• Fix handling when no sub-folders in icon path, only single icons.

Added

• Add model.hasIcon().

Fixed

• Fix normalise-url function causing issues in some cases.

Added

• Add settings override notices for plugin settings screen.

Fixed

• Fix SSL errors with spritesheets and icon sources when devMode is on.

Fixed

• Fix overflow issue for some fields.

Fixed

• Fix JS error causing issues across the control panel.

• Initial (full) release.

• Initial (beta) release.