PHPackages                             pixelkode/statamic-iconsets - 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. pixelkode/statamic-iconsets

Abandoned → [statamic/cms](/?search=statamic%2Fcms)Library[Utility & Helpers](/categories/utility)

pixelkode/statamic-iconsets
===========================

\[DEPRECATED\] A Statamic fieldtype for selecting icons from multiple folders/sets

v1.0.0(5mo ago)16↓80%[5 PRs](https://github.com/pixelkode/statamic-iconsets/pulls)MITPHPPHP ^8.1CI passing

Since Jan 20Pushed 2mo agoCompare

[ Source](https://github.com/pixelkode/statamic-iconsets)[ Packagist](https://packagist.org/packages/pixelkode/statamic-iconsets)[ RSS](/packages/pixelkode-statamic-iconsets/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (1)Versions (7)Used By (0)

Statamic Icon Sets
==================

[](#statamic-icon-sets)

> ⚠️ **Deprecated — no longer maintained.**This addon has been *sherlocked* by Statamic 6: the native `icon` fieldtype combined with `Icon::register()` now covers everything this package did (custom SVG sets, visual picker, raw-SVG output via `{{ icon }}`) — with a better UI. New projects should use the native fieldtype. See **[Migration](#migration-to-the-native-icon-fieldtype)** below.

A Statamic fieldtype that allows selecting icons from multiple folders/sets with visual preview and grouping.

Migration to the native `icon` fieldtype
----------------------------------------

[](#migration-to-the-native-icon-fieldtype)

Statamic 6 replaced the old `directory:` option with registered icon **sets**.

1. Register your set in `app/Providers/AppServiceProvider.php` (`boot()`):

    ```
    use Statamic\Facades\Icon;

    Icon::register('myset', base_path('resources/svg/icons/'));
    ```
2. Update the blueprint field — replace:

    ```
    icon:
      type: iconset
      folders:
        -
    ```

    with:

    ```
    icon:
      type: icon
      set: myset
    ```
3. **Multiple sets in one field** was this addon's only feature core doesn't replicate. Use one native field per set, or register a single combined set directory.
4. **Stored values differ.** This addon stored `folder/filename`; the native `icon`fieldtype stores its own value. Existing entries must be re-selected (or migrated with a one-off script). Template output via `{{ icon }}` (raw SVG) is unchanged.

Features
--------

[](#features)

- Select icons from multiple folders/sets
- Visual icon preview in dropdown
- Folder-based grouping for better organization
- Forward-compatible with Statamic 6's icon set pattern
- Searchable and filterable

Installation
------------

[](#installation)

```
composer require pixelkode/statamic-iconsets
php artisan vendor:publish --tag=statamic-iconsets
```

The publish command copies the compiled JavaScript and CSS assets to your `public/vendor/statamic-iconsets/` directory.

Usage
-----

[](#usage)

Add the fieldtype to your blueprint:

```
icon:
  type: iconset
  display: Icon
  instructions: Select an icon from available sets
  directory: resources/svg/icons  # Optional, defaults to resources/svg/icons
  folders:
    - statamic
    - streamline
  default: statamic/add
```

Configuration
-------------

[](#configuration)

- **directory**: Base directory containing icon folders (default: `resources/svg/icons`)
- **folders**: Array of folder names to include
- **default**: Default icon in `folder/filename` format

Icon Directory Structure
------------------------

[](#icon-directory-structure)

Organize your SVG icons in folders within your configured directory:

```
resources/svg/icons/
├── statamic/
│   ├── add.svg
│   ├── edit.svg
│   └── delete.svg
├── streamline/
│   ├── arrow-right.svg
│   ├── check.svg
│   └── user.svg
└── custom/
    ├── logo.svg
    └── brand-icon.svg

```

Each folder becomes a group in the icon picker dropdown.

Template Usage
--------------

[](#template-usage)

The fieldtype stores the icon value as `folder/filename` (e.g., `streamline/check`). In your Antlers templates, use the `{{ icon }}` tag to render the raw SVG:

```
{{ icon }}
```

This outputs the raw SVG markup, allowing you to style it with CSS:

```

    {{ icon }}

```

Development
-----------

[](#development)

For contributors working on this package:

```
# Install dependencies
npm install

# Build assets for development
npm run dev

# Build assets for production
npm run build
```

After making changes to the Vue components, run `npm run build` to compile the assets.

Requirements
------------

[](#requirements)

- PHP 8.3+
- Statamic 6.0+

License
-------

[](#license)

MIT License. See LICENSE.md for details.

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance78

Regular maintenance activity

Popularity6

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity48

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

Unknown

Total

1

Last Release

164d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9beba63e9160511b708d4e8d225e8f24cf1c107175df0b5000dd350506a4ec81?d=identicon)[Pixelkode](/maintainers/Pixelkode)

![](https://www.gravatar.com/avatar/9fceb1136df896f9ab0d692717b965492f6bca8f4e82b723d8d40b78d6d478ba?d=identicon)[jm@pixelkode.com](/maintainers/jm@pixelkode.com)

![](https://www.gravatar.com/avatar/5b4d7e0ff1ef5981471d5ae3f4a123193e4be6b5eea14146d2d54922b7f6358d?d=identicon)[oliver-dvorski-pk](/maintainers/oliver-dvorski-pk)

---

Top Contributors

[![mynetx](https://avatars.githubusercontent.com/u/6348321?v=4)](https://github.com/mynetx "mynetx (3 commits)")

---

Tags

iconssvgstatamicfieldtypeicon-picker

### Embed Badge

![Health badge](/badges/pixelkode-statamic-iconsets/health.svg)

```
[![Health](https://phpackages.com/badges/pixelkode-statamic-iconsets/health.svg)](https://phpackages.com/packages/pixelkode-statamic-iconsets)
```

###  Alternatives

[statamic/seo-pro

68516.6k](/packages/statamic-seo-pro)[marcorieser/statamic-livewire

A Laravel Livewire integration for Statamic.

23111.5k14](/packages/marcorieser-statamic-livewire)[withcandour/aardvark-seo

Save time and get your Statamic site to rank better with the SEO addon for Statamic.

15133.0k](/packages/withcandour-aardvark-seo)[aerni/livewire-forms

A Statamic forms framework powered by Laravel Livewire

2915.1k](/packages/aerni-livewire-forms)[mitydigital/feedamic

A fully-featured RSS and Atom feed generator for Statamic.

1075.6k](/packages/mitydigital-feedamic)[aerni/advanced-seo

Comprehensive SEO addon for Statamic with flexibility in mind

1818.2k](/packages/aerni-advanced-seo)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)