Firefox Tomorrow

svg element

<filter>

View on MDN ↗

The <filter> SVG element defines a custom filter effect by grouping atomic filter primitives. It is never rendered itself, but must be used by the filter attribute on SVG elements, or the filter CSS property for SVG/HTML elements.

Usage context

Attributes

  • x
  • y
  • width
  • height
  • filterUnits
  • primitiveUnits
  • xlink:href Deprecated

[!NOTE] For <filter>, the x and y attributes default to -10%, and the width and height attributes default to 120%. This is because many filter effects, such as <feGaussianBlur>, extend beyond the bounds of the element being filtered. The default sizing ensures that the filter effect is not clipped.

DOM Interface

This element implements the SVGFilterElement interface.

Examples

Adding a blur effect

SVG

<svg width="230" height="120" xmlns="http://www.w3.org/2000/svg">
  <filter id="blurMe">
    <feGaussianBlur stdDeviation="5" />
  </filter>

  <circle cx="60" cy="60" r="50" fill="green" />

  <circle cx="170" cy="60" r="50" fill="green" filter="url(#blurMe)" />
</svg>

Result

Interactive exampleOpen the canonical MDN source to run this embedded demo.

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also