Changelog
Version History
Stay up to date with the latest features, improvements, and fixes in Open Icons.
26 March 2026
Version 1.2.0
Plugin Rename - Internal alignment with the free version naming conventions. All existing settings, license data, and custom icons are automatically migrated.
Changed
- Plugin Renamed: Plugin is now "Open Icons for ACF" (was "Advanced Custom Fields: Open Icons") to align with the free version on WordPress.org.
- Helper Function: Primary helper function is now
get_openicon(). The previousacf_open_icon()function continues to work as a deprecated alias. - REST API Namespace: REST endpoints moved from
acf-open-icons/v1toopenicon/v1. - Settings Menu: Settings page is now under "Open Icons" in the ACF menu (URL slug changed from
acf-open-iconstoopen-icons-acf). - Upload Directory: Cache and custom icon directories moved from
uploads/acf-open-icons/touploads/open-icons-acf/.
Technical
- Automatic Migration: All option keys, upload directories, and cron jobs are automatically migrated from the old naming on first load after update.
- Namespace Alignment: PHP namespace changed from
ACFOItoOPENICONto match the free version. - Backward Compatibility: Old Lite plugin versions (acf-open-icons-lite) are still detected and deactivated correctly. The
acf_open_icon()helper function remains available as an alias.
14 January 2025
Version 1.1.0
Added
- Custom Icons Library: Upload and manage your own SVG icons directly in the plugin settings. Custom icons are sanitized for security and stored in your uploads directory.
- Telemetry: Anonymous usage statistics to help improve the plugin (sends site URL hash, WP/PHP versions, plugin version, and active icon libraries).
- Fuzzy Search: Improved icon search using uFuzzy library for better matching and typo tolerance.
Changed
- Settings UI: Redesigned settings page with tabs for Providers, Custom Icons, Migration, and License management.
- Badge Component: Updated badge variants with improved color schemes for better visual hierarchy.
- Toast Notifications: Refined toast styling for consistency with the design system.
Technical
- REST API: Extended endpoints for custom icon CRUD operations (upload, list, delete).
- Provider System: Custom icons now integrate seamlessly as a provider option alongside Lucide, Tabler, and Heroicons.
3 December 2025
Version 1.0.3
Fixed
- Tabler Icons Path Structure: Fixed issue where some Tabler Icons (including rosette-discount variants) were not loading. Tabler Icons now organizes icons in
outline/andfilled/subdirectories instead of directly in theicons/directory. The plugin now correctly fetches icons fromicons/outline/{key}.svg(default) and falls back toicons/filled/{key}.svgif needed. This ensures all Tabler Icons variants load correctly.
30 November 2025
Version 1.0.2
Fixed
- "Use Last Color" Context Isolation: Fixed "Use Last Color" feature to properly isolate color storage per instance of flexible layouts and repeaters. Previously, all instances of the same layout type shared the same last color, causing new instances to incorrectly inherit colors from previous instances. Now each layout instance and repeater row has its own isolated storage.
- Admin Preview Color Updates: Fixed issue where admin post edit screen showed old colors after palette token values were updated in settings. The preview now regenerates SVG from the current
colorTokenand palette settings, ensuring it always displays the current color values. The stored SVG in the database is also updated when saving the post.
Technical
- Instance Index Extraction: Improved context detection to extract flexible layout instance IDs and repeater row IDs from ACF input name paths, supporting both numeric and alphanumeric identifier formats.
24 November 2025
Version 1.0.1
Fixed
- Dev Mode Detection: Prevent the admin from entering dev mode just because another Vite server is running locally. The plugin now verifies its own dev entry before loading dev assets and exposes filters/constants for overriding host/port if needed.
21 November 2025
Version 1.0.0
Major Release - Production Ready. This is the first stable production release of ACF Open Icons. The plugin has been thoroughly cleaned, documented, and optimized for production use.
Added
- Usage Examples: USAGE_EXAMPLE.md included in production builds for developer reference.
Fixed
- Build Process: Fixed build configuration to use esbuild instead of terser (no external dependency required).
- Version Synchronization: Ensured consistent versioning across package.json, plugin header, and CHANGELOG.
Technical
- Security Review: Verified all security best practices (sanitization, escaping, prepared statements, nonces).
- Performance: Reviewed and optimized asset loading, database queries, and caching.
- File Structure: Verified production ZIP contains only necessary files.
- Version Management: Automated version synchronization in build process.
Have a feature request?
We'd love to hear your ideas! Your feedback helps us prioritise what to build next and make Open Icons even better for your workflow.
Get in Touch