Omni Icon is a comprehensive icon management solution that seamlessly integrates icons across the WordPress ecosystem. Upload custom icons, use bundled icons, or access 200,000+ icons from Iconify with support for Gutenberg, Elementor, Bricks, Breakdance, and LiveCanvas.<\/p>\n\n
Omni Icon is packed with features designed to make icon management effortless:<\/p>\n\n
<omni-icon><\/code> custom element anywhere in your theme or content<\/li>\n- Secure<\/strong>: SVG sanitization prevents XSS attacks on uploaded icons<\/li>\n
- Modern Architecture<\/strong>: Built with PHP 8.0+ attributes, Symfony DI, and auto-discovery<\/li>\n
- Lightweight<\/strong>: Small footprint with lazy loading won't slow down your site<\/li>\n<\/ul>\n\n
Visit our GitHub repository<\/a> for more information.<\/p>\n\nSeamless Integration<\/h3>\n\n
Omni Icon works perfectly with the most popular visual\/page builders:<\/p>\n\n
\n- Gutenberg<\/a> \/ Block Editor \u2014 Custom Icon block with live preview<\/li>\n
- Elementor<\/a> \u2014 Native widget with Elementor controls<\/li>\n
- Bricks<\/a> \u2014 Native element with full theme compatibility<\/li>\n
- Breakdance<\/a> \u2014 Element Studio integration with SSR<\/li>\n
- LiveCanvas<\/a> \u2014 Custom block with panel controls<\/li>\n
- Advanced Custom Fields (ACF)<\/a> \u2014 Custom field type for icon selection<\/li>\n
- Etch<\/a> \u2014 Web Component with icon picker<\/li>\n
- Divi 5<\/a> \u2014 Native module<\/li>\n
- More integrations coming soon!<\/li>\n<\/ul>\n\n
Icon Sources<\/h3>\n\n
Local Icons (Custom Uploads)<\/strong>\nUpload your own SVG icons and organize them in custom sets. All uploads are sanitized for security.<\/p>\n\nBundle Icons<\/strong>\nPre-packaged icons included with the plugin, including sponsor logos and commonly used icons.<\/p>\n\nIconify Icons<\/strong>\nAccess to 150+ icon collections with 200,000+ icons including:<\/p>\n\n\n- Material Design Icons (mdi)<\/li>\n
- Font Awesome (fa6-brands, fa6-regular, fa6-solid)<\/li>\n
- Bootstrap Icons (bi)<\/li>\n
- Hero Icons (heroicons)<\/li>\n
- Lucide (lucide)<\/li>\n
- And 150+ more collections<\/li>\n<\/ul>\n\n
Browse available icons at Iconify<\/a><\/p>\n\nUsage<\/h3>\n\n
Gutenberg<\/strong>:<\/p>\n\n\n- In the block editor, add a new \"Omni Icon\" block<\/li>\n
- Click the icon picker to browse or search icons<\/li>\n<\/ul>\n\n
Elementor<\/strong>:<\/p>\n\n\n- Add the \"Omni Icon\" widget<\/li>\n
- Click \"Browse Icons\" to open the icon picker<\/li>\n<\/ul>\n\n
Bricks<\/strong>:<\/p>\n\n\n- Add the \"Omni Icon\" element<\/li>\n
- Click \"Browse Icons\" to open the icon picker<\/li>\n<\/ul>\n\n
Breakdance<\/strong>:<\/p>\n\n\n- Add the \"Omni Icon\" element<\/li>\n
- Click \"Browse Icons\" to open the icon picker<\/li>\n<\/ul>\n\n
LiveCanvas<\/strong>:<\/p>\n\n\n- Add the \"Omni Icon\" element<\/li>\n<\/ul>\n\n
Advanced Custom Fields (ACF)<\/strong>:<\/p>\n\n\n- Create or edit an ACF Field Group<\/li>\n
- Add a new field and select \"Omni Icon\" as the field type<\/li>\n
- Configure return format (string, array, or HTML)<\/li>\n<\/ul>\n\n
Etch<\/strong>:<\/p>\n\n\n- Add the \"omni-icon\" Element from the menu element on the bottom of screen<\/li>\n
- Browse or search icons in the icon picker<\/li>\n
- Confirm selection to copy the code to clipboard <\/li>\n
- Paste the copied code into the HTML editor<\/li>\n<\/ul>\n\n
Web Component Usage<\/strong><\/p>\n\nUse the <omni-icon><\/code> web component directly in your theme or content:<\/p>\n\n<omni-icon name=\"mdi:home\"><\/omni-icon>\n<omni-icon name=\"local:my-logo\" width=\"64\" height=\"64\"><\/omni-icon>\n<omni-icon name=\"fa6-solid:heart\" color=\"#3b82f6\"><\/omni-icon>\n<\/code><\/pre>\n\nPerformance & Security<\/h3>\n\n\n- Lazy Loading<\/strong>: Web components loaded on-demand<\/li>\n
- Multi-layer Caching<\/strong>: Memory \u2192 Filesystem \u2192 IndexedDB<\/li>\n
- SSR Support<\/strong>: Icons pre-rendered on server for instant display<\/li>\n
- SVG Sanitization<\/strong>: All uploaded SVGs sanitized to prevent XSS<\/li>\n
- MIME Type Validation<\/strong>: Server-side validation of uploaded files<\/li>\n<\/ul>\n\n
Love Omni Icon?<\/h4>\n\n\n- Give a 5-star review<\/a><\/li>\n
- Join our Facebook Group<\/a><\/li>\n
- Sponsor us on GitHub<\/a> or Ko-fi<\/a><\/li>\n<\/ul>\n\n
Credits<\/h4>\n\n\n- Built with Symfony UX Icons<\/a><\/li>\n
- Powered by Iconify<\/a><\/li>\n
- SVG sanitization by enshrined\/svg-sanitize<\/a><\/li>\n<\/ul>\n\n
Affiliate Disclosure: This readme.txt may contain affiliate links. If you decide to make a purchase through these links, we may earn a commission at no extra cost to you.<\/p>\n\n\n
\nWhat icon sources does Omni Icon support?<\/h3><\/dt>\nOmni Icon supports three icon sources:\n1. Local Icons - Upload your own custom SVG icons\n2. Bundle Icons - Pre-packaged icons included with the plugin\n3. Iconify Icons - Access to 200,000+ icons from 150+ collections<\/p><\/dd>\n
How do I use icons in my theme?<\/h3><\/dt>\nYou can use the <omni-icon><\/code> web component directly in your theme templates:\n <\/p>\n\nThe component supports many attributes like width, height, and color for customization.<\/p><\/dd>\n
Which page builders are supported?<\/h3><\/dt>\nOmni Icon currently supports:\n- Gutenberg \/ Block Editor\n- Elementor\n- Bricks\n- Breakdance\n- LiveCanvas\n- Etch\n- And more coming soon!<\/p>\n\n
All integrations include icon picker modals for easy icon selection.<\/p><\/dd>\n
Are uploaded SVG icons safe?<\/h3><\/dt>\nYes! All uploaded SVG files are sanitized using enshrined\/svg-sanitize to prevent XSS attacks and security vulnerabilities.<\/p><\/dd>\n
Does Omni Icon require an internet connection?<\/h3><\/dt>\nFor local and bundle icons, no internet connection is required. Iconify icons are fetched from the Iconify API and cached locally for optimal performance.<\/p><\/dd>\n
What is Server-Side Rendering (SSR)?<\/h3><\/dt>\nSSR means icons are pre-rendered on the server and sent as inline SVG in the HTML. This provides instant display without JavaScript required, improving performance and SEO.<\/p><\/dd>\n
Can I use Omni Icon with any WordPress theme?<\/h3><\/dt>\nYes, Omni Icon is compatible with any WordPress theme. You can use the web component, Gutenberg block, or page builder integrations with any theme.<\/p><\/dd>\n
What 3rd Party services used?<\/h3><\/dt>\nOmni Icon uses the Iconify API to fetch icons from their extensive icon collections.<\/p><\/dd>\n
Where can I find the source code for compiled\/minified files?<\/h3><\/dt>\nThe complete source code, including uncompiled versions of all JavaScript and CSS files in the dist\/<\/code> directory, is publicly available on GitHub<\/a><\/p><\/dd>\n\n<\/dl>\n\n\n1.0.17 - 2026-03-25<\/h4>\n\n
Changed<\/strong><\/p>\n\n\n- Migrate the build system to
@nabasa\/vp-wp<\/code><\/a> for improved performance and better WordPress integration<\/li>\n<\/ul>\n\n1.0.16 - 2026-03-18<\/h4>\n\n
Added<\/strong><\/p>\n\n\n- Divi 5<\/a> integration<\/li>\n<\/ul>\n\n
Fixed<\/strong><\/p>\n\n\n- Release build Symfony DI ParameterBag scoping issue<\/li>\n<\/ul>\n\n
1.0.15 - 2026-01-30<\/h4>\n\n
Changed<\/strong><\/p>\n\n\n- Update readme file<\/li>\n<\/ul>\n\n
1.0.14 - 2026-01-14<\/h4>\n\n
Added<\/strong><\/p>\n\n\n- Etch<\/a> integration<\/li>\n<\/ul>\n\n
Changed<\/strong><\/p>\n\n\n- Increase webcomponent concurrent request limit from 4 to 16 for faster icon loading<\/li>\n<\/ul>\n\n
Fixed<\/strong><\/p>\n\n\n- Missing assets entrypoint in Vite config for ACF integration<\/li>\n<\/ul>\n\n
1.0.13 - 2026-01-13<\/h4>\n\n
Fixed<\/strong><\/p>\n\n\n- Redis compatibility issue<\/li>\n<\/ul>\n\n
1.0.12 - 2026-01-12<\/h4>\n\n
Fixed<\/strong><\/p>\n\n\n- PHP 8.1 compatibility issues<\/li>\n<\/ul>\n\n
1.0.11 - 2026-01-12<\/h4>\n\n
Added<\/strong><\/p>\n\n\n- Blueprint for WordPress.org plugin repository<\/li>\n<\/ul>\n\n
1.0.9 - 2026-01-12<\/h4>\n\n
Changed<\/strong><\/p>\n\n\n- Update readme file<\/li>\n<\/ul>\n\n
1.0.7 - 2026-01-12<\/h4>\n\n
Fixed<\/strong><\/p>\n\n\n- [ACF] Discovery compatibility issue<\/li>\n<\/ul>\n\n
1.0.4 - 2026-01-09<\/h4>\n\n
Added<\/strong><\/p>\n\n\n- ACF (Advanced Custom Fields) integration #4<\/a><\/li>\n<\/ul>\n\n
Fixed<\/strong><\/p>\n\n\n- Modal footer visibility on laptop screens - Confirm\/Cancel buttons now visible without requiring full-screen mode #3<\/a><\/li>\n
- WordPress.org plugin repository compliance fixes<\/li>\n<\/ul>\n\n
1.0.3 - 2026-01-08<\/h4>\n\n
Fixed<\/strong><\/p>\n\n\n- WordPress.org plugin repository compliance fixes<\/li>\n<\/ul>\n\n
1.0.2 - 2025-12-31<\/h4>\n\n
Added<\/strong><\/p>\n\n\n- Multiple and drag-and-drop icon upload support - upload multiple SVG files at once<\/li>\n
- Multi-select icons with keyboard shortcuts (Ctrl\/Cmd+Click, Shift+Click) and mouse drag area selection for bulk operations<\/li>\n<\/ul>\n\n
1.0.1 - 2025-12-31<\/h4>\n\n
Fixed<\/strong><\/p>\n\n