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.
= 2.0.0 = 2024-11-08
If you're upgrading from a version before v2.0.0 and have icons with custom rotation and styling, you may notice slight changes in their appearance. This is due to an update in how rotation is managed within the block.
Added
- Added full 360 degree rotation support.
- Added support for
contentOnly
editing.
- Added support for text nodes within SVG icons.
- Added localStorage support for the preview size in the Icon Library.
Changed
- Updated "Tested up to" to WordPress 6.7.
- Updated minimum WordPress version to 6.5.
- Updated the way rotation and vertical/horizontal flipping are handled. CSS classes are no longer used.
- Updated the deprecated
useSetting
function to useSettings
.
- Improved the positioning of the quick inserter modal.
- Updated the icon placeholder to better match Core.
- Updated the link control to better match Core.
- Updated general component styling to match Core.
Removed
- Removed the deprecated
getEditorSettings
conditional.
Fixed
- Fixed the bug where values would not get reset when closing the custom icon editor modal.
- Fixed the nested toolbar visual bug by replacing
DropdownMenu
with Dropdown
.
= 1.9.0 = 2024-07-20
Added
- Add support for
clientNavigation
interactivity, meaning that the Icon Block can now be placed in Query Loops with client-side navigation enabled.
Changed
- Update "Tested up to" to WordPress 6.6.
- Update minimum WordPress version to 6.4.
- Update minimum PHP version 7.4.
- Update the settings panel to use the
ToolsPanel
component, which is consistent with WordPress Core.
- Update the Playground blueprint for the Live Preview.
Removed
- Remove the custom
OptionsPanel
component in favor of the Core ToolsPanel
and ToolsPanelItems
components.
Fixed
- Fix the bug causing icon categories to become unalphabetized after the search.
- Fix text overflow bug caused by custom icon categories with long names.
- Fix the bug where the icon color input would get duplicated when setting the icon label. This occurred when
blockInspectorTabs
was set to false
.
- Fix a typo in the "Justify Stretch" icon name.
= 1.8.0 = 2024-03-24
Added
- The Icon Block can now be added to Navigation blocks (requires WordPress 6.5 or Gutenberg 17.6+)
- Add Playground blueprint for live preview in the Plugin Directory.
Changed
- Update "Tested up to" to WordPress 6.5.
- Update "Requires at least" to WordPress 6.3.
1.7.0 - 2024-01-02
Added
Changed
- Bump the "Tested up to" version to WordPress 6.4.
- Update hover styles in icon pickers to match Core styling.
- Remove custom placeholder illustration.
Fixed
- Fix the text area height in the custom icon editor modal.
1.6.0 - 2023-07-29
Added
- Add Threads and WhatsApp social icons.
- Add Core icons new in WordPress 6.2: Border, Caption, Chevron Up/Down, Comment Edit Link, Copy, Drawer Left, Drawer Right, Filter, Justify Stretch, Line Dashed, Line Dotted, Line Solid, List Item, Lock Outline, Lock Small, Seen, Shadow, Shuffle, and Unseen
Changed
- Update minimum required WordPress version to 6.2. We want to be utilizing the latest functionality in WordPress.
- Update to block API v3 for better 6.3 compatibility.
- Disable dimension and border default controls for better 6.3 compatibility.
- Move color controls to the native "color" panel. (#35)
- Simplify transform CSS. (#32)
1.5.0 - 2023-03-09
Added
- Add dropzone support for media library uploads and custom SVGs.
- Add support for style elements in custom SVGs.
- Add the ability to insert an SVG icon from the Media Library if SVG uploads are enabled on the website.
- Add the ability to clear the current icon.
Changed
- Update the block inspector panels for WordPress 6.2 compatibility.
- Update the replace dropdown to use the native DropDownMenu component for improved WordPress 6.2 compatibility.
Fixed
- Fix invalid DOM properties error. Thanks @DeoThemes for reporting this issue and suggesting a solution! (#25)
- Fix a few minor CSS issues for WordPress 6.2 compatibility.
1.4.0 - 2023-01-03
Added
Changed
- Update WordPress version requirement to 6.0+.
- Update icon color handling to better support Global Styles.
- Update icon width control to support additional units.
- Update settings panel to mirror Core
ToolsPanel
implementations and support setting resets.
1.3.2 - 2022-10-17
Fixed
- Fix incorrect class specification.
- Fix placeholder background color in prep for WordPress 6.1.
1.3.1 - 2022-10-01
Fixed
- Fix alignment classes not getting applied in the correct spot.
1.3.0 - 2022-09-20
Added
- Add the ability to toggle icon color fill. Useful for SVG icons that use stroke.
- Add the ability to disable custom icons using the
iconBlock.enableCustomIcons
filter.
- Add title attribute support.
- Add alternative Reddit icon to match WordPress core.
- Add new WordPress icon:
title
Changed
- Update block architecture to support features in WordPress 6.1.
- Update block placeholder to be more consistent with core placeholders.
- Improve support for custom icons without a fill color.
- Improve the UI in various places.
Removed
- Remove deprecated WordPress icons:
archiveTitle
, commentTitle
, postTitle
, and queryTitle
Fixed
- Fix bug where icon color and fill were overridden by theme colors.
- Fix visual inconsistency between the frontend and Editor due to box-sizing not getting applied in the Editor.
1.2.0 - 2022-05-02
Added
- Add alpha support for icon and background colors.
- Add link rel support.
- Add support for custom icon types.
- Add new WordPress icons:
post
, postTerms
, queryTitle
, removeSubmenu
, and row
Changed
- Remove deprecated WordPress icons:
alignJustifyAlt
, cogAlt
, and trashFilled
1.1.2 - 2022-01-27
Fixed
- Fix bug where custom SVG icons with
style
attributes would not render correctly. Thanks @endres for reporting this issue.
1.1.1 - 2022-01-25
Changed
- Include both theme and WordPress default color palettes in the icon and background color picker.
1.1.0 - 2022-01-25
Added
- Add additional border support (color, width, style)
- Add margin support
- Add the ability to set an
aria-label
on the icon and link.
- Add the core Unlock icon.
- Add the core Comment Author Avatar icon.
- Add the core Comment Author Name icon.
- Add the core Comment Content icon.
- Add the core Comment Edit Link icon.
- Add the core Comment Reply Link icon.
Changed
- Update inserter modal components to use
isFullScreen
to better resemble core modals.
- Update styling on inserter modals for improved mobile responsiveness.
- Import the Align None, Color, Reset, and Styles icons directly from @wordpress/icons.
- Remove the custom search component in favor of the core component from @wordpress/components.
- Restructure stylesheets to better conform with block standards.
Fixed
- Fix bug where hyphens and colons would be incorrectly stripped from attribute names in custom icons. Thanks @stokesman for the PR. (#5)
1.0.0 - 2021-10-06
Added
- Added the WordPress icon library featuring 270+ icons.
- Add new placeholder and quick icon insertion experience.
- Added new custom icon editing modal for an improved insertion experience.
0.1.2 - 2021-09-27
Added
- Added scale transform on the frontend when an icon is linked to improve a11y. This matches the hover styling in the core WordPress Social Icons block. Future improvements are planned, including dedicated hover/focus settings within the block itself.
Fixed
- Fixed translation file.
- Fixed version in block.json so block can be added to the Block Directory.
0.1.1 - 2021-09-25
Fixed
- Fixed SVG sanitization for non-standard SVGs.
0.1.0 - 2021-09-25