symfony/ux-icons
Renders local and remote SVG icons in your Twig templates.
v3.4.0
8.2M downloads/mo
#1038 most downloaded on Packagist
symfony/ux-icons
What this package is like to depend on
Last release 25 days ago
29 Jul 2026
Ships fairly regularly
a new release about every 5 weeks
Some releases are documented
notes for 16 of 30 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
30 releases · first in 2024
9 releases in the last 12 months
see the full history below
Release timeline
27 releases · Apr 2024 to Jul 2026Releases
latest 30-
v3.4.029 Jul 2026Release notes
Open source →Changelog (v3.3.0...v3.4.0)
- feature #3741 Add
auto_lockto persist on-demand icons (@Kocal)
Release notes
Open source →- Add
iconify.auto_lockoption to persist "on demand" icons to the local icon directory as they are rendered
- feature #3741 Add
-
v3.3.019 Jun 2026 -
v3.2.0no dateRelease notes
Open source →Changelog (v3.1.0...v3.2.0)
- security #cve-2026-55877 Sanitize Iconify SVG output and unify icon creation (@Kocal)
Release notes
Open source →- Sanitize rendered SVG icons (Iconify bodies and local files) to prevent XSS. See section 2.36.1 below for details
-
v3.1.022 May 2026 -
v3.0.009 Apr 2026Release notes
Open source →Changelog (v2.34.0...v3.0.0)
- feature #3453 Update minimum required Symfony version to 7.4 (@Kocal)
- feature #3450 Upgrade minimum required PHP version to 8.4 (@Kocal)
- feature #3407 Allow Symfony UX 3.x packages (@Kocal)
- bug #3398 Post-merge fixes for 3.x (@Kocal)
- bug #3187 Add phpunit.dist.xml in .gitattributes (@Kocal)
- bug #3182 Drop Symfony PHPUnit Bridge in favor of PHPUnit >= 11.0 (@Kocal)
- feature #2998 Upgrade minimum required PHP version to 8.2 (@Kocal)
- feature #2996 Update minimum required Symfony version to ^6.4 (@Kocal)
Release notes
Open source →- Minimum required Symfony version is now 7.4
- Minimum required PHP version is now 8.4
-
v2.36.116 Jun 2026Release notes
Open source →Changelog (v2.36.0...v2.36.1)
- security #cve-2026-55877 Sanitize Iconify SVG output and unify icon creation (@Kocal)
Release notes
Open source →-
Sanitize rendered SVG icons (Iconify bodies and local files) to prevent XSS. Removed from icon output:
- Elements:
<script>,<foreignObject>,<iframe>,<object>,<embed>,<handler> - SMIL animation elements (
<animate>,<set>,<animateTransform>,<animateMotion>) when they target anon*,hreforxlink:hrefattribute - CDATA sections and processing instructions (otherwise re-serialized as raw HTML)
- Event-handler attributes (
on*, e.g.onload,onclick) on every element href/xlink:hrefvalues with a non-allowlisted scheme such asjavascript:,vbscript:,data:text/htmlordata:image/svg+xml(allowed:http(s),mailto,tel,data:image/*raster, fragments and relative URLs)
<style>elements are kept (so light/dark-mode theming keeps working), with their event-handler attributes stripped and</style>breakouts dropped.Clear your icon cache after upgrading so already-cached icons are re-sanitized.
- Elements:
-
v2.36.003 Apr 2026 -
v2.35.0no dateRelease notes
Open source →Changelog (v2.34.0...v2.35.0)
- feature #3407 Allow Symfony UX 3.x packages (@Kocal)
-
v2.34.026 Feb 2026 -
v2.33.0no date -
v2.32.002 Dec 2025Nothing published for this version
-
v2.31.030 Sep 2025Nothing published for this version
-
v2.30.027 Aug 2025Nothing published for this version
-
v2.29.214 Aug 2025Nothing published for this version
-
v2.29.005 Aug 2025 -
v2.28.230 Jul 2025Nothing published for this version
-
v2.28.025 Jul 2025Nothing published for this version
-
v2.27.017 Jun 2025Nothing published for this version
-
v2.26.030 May 2025Nothing published for this version
-
v2.25.007 Apr 2025 -
v2.24.004 Apr 2025Release notes
Open source →- Add
xmlnsattribute to icons downloaded with Iconify, to correctly render icons browser as an external file, in SVG editors, and in files explorers or text editors previews. It may breaks your pipeline if you assert onux_icon()or<twig:ux:icon>output in your tests, and forgot to lock your icons. We recommend you to lock your icons before upgrading to UX Icons 2.24. We also suggest you to to force-lock your icons after upgrading to UX Icons 2.24, to add the attributexmlnsto your icons already downloaded from Iconify.
- Add
-
v2.23.026 Dec 2024Nothing published for this version
-
v2.22.104 Dec 2024Nothing published for this version
-
v2.22.029 Nov 2024Nothing published for this version
-
v2.21.021 Oct 2024Nothing published for this version
-
v2.20.018 Sep 2024Release notes
Open source →- Add
aliasesconfiguration option to define icon alternative names. - Add support for
intandfloatattribute values in<twig:ux:icon />. - Add support for Icon sets, configurable with
icon_setsoption.
- Add
-
v2.19.007 Aug 2024Release notes
Open source →- Add
ignore_not_foundoption to silence error during rendering if the icon is not found.
- Add
-
v2.18.107 Jun 2024Nothing published for this version
-
v2.18.004 Jun 2024Nothing published for this version
-
v2.17.019 Apr 2024