<image>

The <image> SVG element includes images inside SVG documents. It can display raster image files or other SVG files.

The only image formats SVG software must support are JPEG, PNG, and other SVG files. Animated GIF behavior is undefined.

SVG files displayed with <image> are treated as an image: external resources aren't loaded, :visited styles aren't applied, and they cannot be interactive. To include dynamic SVG elements, try <use> with an external URL. To include SVG files and run scripts inside them, try <object> inside of <foreignObject>.

Usage context

Attributes

Global attributes

• Conditional processing attributes
• Core attributes
• Graphical event attributes
• Presentation attributes
• Xlink attributes
• class
• style
• externalResourcesRequired
• transform

Specific attributes

• x: Positions the image horizontally from the origin.
• y: Positions the image vertically from the origin.
• width: The width the image renders at. Unlike HTML's <img>, this attribute is required.
• height: The height the image renders at. Unlike HTML's <img>, this attribute is required.
• href and xlink:href: Points at a URL for the image file.
• preserveAspectRatio: Controls how the image is scaled.

DOM Interface

<image> implements the SVGImageElement interface.

Example

Basic rendering of a PNG image in SVG:

SVG

<svg width="200" height="200"
  xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
  <image href="https://mdn.mozillademos.org/files/6457/mdn_logo_only_color.png" height="200" width="200"/>
</svg>

Result

Specifications

Browser compatibility