PHPackages eminos/statamic-iconify - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. eminos/statamic-iconify ActiveStatamic-addon[Utility & Helpers](/categories/utility) eminos/statamic-iconify ======================= A Statamic addon to use Iconify icons in your Statamic site. v2.1.0(3mo ago)412.8k↓74.9%2MITPHP Since Sep 15Pushed 3mo ago1 watchersCompare [ Source](https://github.com/eminos/statamic-iconify)[ Packagist](https://packagist.org/packages/eminos/statamic-iconify)[ RSS](/packages/eminos-statamic-iconify/feed)WikiDiscussions main Synced 2d ago READMEChangelog (8)Dependencies (5)Versions (11)Used By (0) Statamic Iconify ================ [](#statamic-iconify) A Statamic plugin for the fantastic [Iconify](https://iconify.design/) framework. This plugin gives you an Iconify fieldtype in Statamic where you can search and pick an icon from the huge icon library that Iconify provides. [![Screenshot of the search and select icon GUI](docs/screenshot1.png)](docs/screenshot1.png) Installation ------------ [](#installation) Install this plugin using composer. ``` composer require eminos/statamic-iconify ``` Statamic support ---------------- [](#statamic-support) Statamic versionAddon versionAddon branchStatamic 5`1.x``1.x`Statamic 6`2.x``main`Features -------- [](#features) - Search the library of Iconify icons. - Over 200,000 open source icons loaded on demand. - Uses Iconify's API (always updated icon sets). - **Filter by icon set, category, or license** — at the global config level or per-field. - Global config file to lock down allowed icon sets site-wide. - Dark mode support. - Store as icon name (load on demand) or SVG data (no API calls on frontend). - Antlers tag to render stored SVG icons. Configuration ------------- [](#configuration) Publish the config file: ``` php artisan vendor:publish --tag=statamic-iconify-config ``` This creates `config/statamic-iconify.php` where you can set global restrictions: ``` return [ // Only allow these icon sets (empty = all) 'allowed_prefixes' => ['mdi', 'tabler', 'heroicons', 'ph'], // Only allow icon sets from these categories (empty = all) // Available: Material, UI 24px, UI 16px / 32px, UI Multicolor, // UI Other / Mixed Grid, Thematic, Emoji, Logos, Flags / Maps, // Animated Icons, Archive / Unmaintained 'allowed_categories' => [], // Only allow icon sets with these licenses (empty = all) // e.g. 'MIT', 'Apache 2.0', 'CC BY 4.0' 'allowed_licenses' => [], // Default storage format for new fields 'default_store_as' => 'name', ]; ``` ### Field-level configuration [](#field-level-configuration) Each Iconify field in your blueprints can further narrow the available icons: - **Icon Sets** — Multi-select dropdown of available icon sets (filtered by global config) - **Category** — Single select dropdown of icon set categories - **Licenses** — Multi-select dropdown of license types - **Store as** — Icon name or SVG data Field-level settings can only narrow within what the global config allows, never widen. Usage ----- [](#usage) Depending on how you chose to store the icon, you have a few options for rendering it on the frontend. ### Storing only the **icon name** [](#storing-only-the-icon-name) You can use any of Iconify's methods/components to display the icon in the frontend. Here is an example with their web component that fetches the icon on demand through their API. ``` ``` Read more about how you can use the icons in the [Iconify usage documentation](https://iconify.design/docs/usage/). ### Storing the icon as **SVG Data** [](#storing-the-icon-as-svg-data) If you store the icon as "SVG Data" you can render the SVG using the provided Antlers Tag. The advantage is that there are no API calls to Iconify after you have picked the icon — the data to render the icon is stored in your field. ``` {{ iconify:icon_field }} ``` renders: ``` ``` You can also add attributes and/or override the icon's defaults: ``` {{ iconify:icon_field class="text-xl" aria-label="Home icon" }} ``` Testing ------- [](#testing) ``` # PHP tests (Pest) ./vendor/bin/pest # JavaScript tests (Vitest) npm run test ``` License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 45 — FairBetter than 91% of packages Maintenance78 Regular maintenance activity Popularity31 Limited adoption so far Community9 Small or concentrated contributor base Maturity50 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~113 days Recently: every ~167 days Total 9 Last Release 116d ago Major Versions v0.1.0 → v1.0.02023-10-02 v1.3.0 → v2.02026-01-19 1.x-dev → v2.1.02026-03-09 ### Community Maintainers ![](https://www.gravatar.com/avatar/5f7b9b5acefc797c0c0cf24b4b05ce1f55e50a0c20e5bdbf647eae53b0a16fab?d=identicon)[eminos](/maintainers/eminos) --- Top Contributors [![eminos](https://avatars.githubusercontent.com/u/1682784?v=4)](https://github.com/eminos "eminos (15 commits)") --- Tags iconifystatamicstatamic-addonstatamic-v5statamic-v6 ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/eminos-statamic-iconify/health.svg) ``` [![Health](https://phpackages.com/badges/eminos-statamic-iconify/health.svg)](https://phpackages.com/packages/eminos-statamic-iconify) ``` ### Alternatives [statamic/seo-pro 68516.6k](/packages/statamic-seo-pro)[statamic-rad-pack/runway Eloquently manage your database models in Statamic. 135224.7k7](/packages/statamic-rad-pack-runway)[rias/statamic-redirect 29335.6k](/packages/rias-statamic-redirect)[duncanmcclean/statamic-cargo Comprehensive e-commerce addon for Statamic. Build bespoke e-commerce sites without the complexity. 3416.9k](/packages/duncanmcclean-statamic-cargo)[jacksleight/statamic-bard-texstyle 18195.4k](/packages/jacksleight-statamic-bard-texstyle)[marcorieser/statamic-livewire A Laravel Livewire integration for Statamic. 23111.5k15](/packages/marcorieser-statamic-livewire) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)