A package to easily make use of Heroicons in your Laravel Blade views.

Fund package maintenance!

Installs: 7 463 174

Dependents: 79

Suggesters: 3

Security: 0

Stars: 537

Watchers: 7

Forks: 50

Open Issues: 0

2.4.0 2024-07-16 07:00 UTC


Blade Heroicons

Tests Coding Standards Latest Stable Version Total Downloads

A package to easily make use of Heroicons in your Laravel Blade views.

For a full list of available icons see the SVG directory or preview them at Heroicons are originally developed by Steve Schoger and Adam Wathan.


  • PHP 8.0 or higher
  • Laravel 9.0 or higher


composer require blade-ui-kit/blade-heroicons


Please refer to the upgrade guide when updating the library.

Blade Icons

Blade Heroicons uses Blade Icons under the hood. Please refer to the Blade Icons readme for additional functionality. We also recommend to enable icon caching with this library.


Blade Heroicons also offers the ability to use features from Blade Icons like default classes, default attributes, etc. If you'd like to configure these, publish the blade-heroicons.php config file:

php artisan vendor:publish --tag=blade-heroicons-config


Icons can be used as self-closing Blade components which will be compiled to SVG icons:


You can also pass classes to your icon components:

<x-heroicon-o-arrow-left class="w-6 h-6 text-gray-500"/>

And even use inline styles:

<x-heroicon-o-arrow-left style="color: #555"/>

Or use the @svg directive:

@svg('heroicon-o-arrow-left', 'w-6 h-6', ['style' => 'color: #555'])

The solid icons can be referenced like this:


The mini icons can be referenced like this:


And the micro icons can be referenced like this:


Raw SVG Icons

If you want to use the raw SVG icons as assets, you can publish them using:

php artisan vendor:publish --tag=blade-heroicons --force

Then use them in your views like:

<img src="{{ asset('vendor/blade-heroicons/o-arrow-left.svg') }}" width="10" height="10"/>


Check out the CHANGELOG in this repository for all the recent changes.


Blade Heroicons is developed and maintained by Dries Vints.


Blade Heroicons is open-sourced software licensed under the MIT license.