CSS Linked Parameters for SVG

Description

Linked parameters provides three ways for developers to style SVG images.

img {
    link-parameters: param(--color, blue);
}

<img src="example.svg#:~:param(--color,blue)">

.icon {
  background-image: url("example.svg", param(--color, blue));
}

Specification

https://drafts.csswg.org/css-link-params/

web-feature

web-features: link-parameters
https://web-platform-dx.github.io/web-features-explorer/features/link-parameters/

Test Links

https://wpt.fyi/results/svg/styling/css-linked-parameters?label=experimental&label=master&aligned

Additional Signals

This feature received 40 👍 in last years Interop.
Developer Signals entry
The Chromium issue has 17 +1s.
This Tweet about the feature received 111 likes.
This Bluesky post about the feature received 134 likes.
Implementation work in Firefox is ongoing.

In the 2025 State of HTML survey, SVG came second in the Graphics & Multimedia Pain Points chart. In the comments, certain issues were voiced repeatedly:

• "No way to pass currentColor and other params to remote SVGs makes icons very hard to manage"
• "I'd like to refer to an SVG (e.g. to use as a repeated icon) that's less verbose than <svg><use>...</use></svg>"
• “Want to be able to do <img src='file.svg'> and still retain ability to style. Currently if i want to pass through currentColor for example i have to inline the entire icon which is silly if i'm using it in dozens of places"
• "Inlining SVGs causes a lot of repetition and noise in the HTML"

Currently developers are using unfortunate workarounds such as mask-image.
The <use> element provides something of a solution but is more complex and verbose than an <img>. <use> elements are stripped out by the Web Sanitizer.

Start by reading the CSS Linked Parameters specification and the linked web-features entry. Then inspect the SVG styling results on WPT.fyi and the linked browser implementation issue; the scope is complete when support for the three described parameter forms is evaluated against the specification and relevant tests.