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

The only image formats SVG software must support areJPEG,PNG, and other SVG files. AnimatedGIF behavior is undefined.

SVG files displayed with<image> aretreated as an image: external resources aren't loaded,:visited stylesaren'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

x

Positions the image horizontally from the origin.Value type:<length> |<percentage>;Default value:0;Animatable:yes

y

Positions the image vertically from the origin.Value type:<length> |<percentage>;Default value:0;Animatable:yes

width

The width the image renders at. Unlike HTML's<img>, this attribute is required.Value type:<length> |<percentage>;Default value:auto;Animatable:yes

height

The height the image renders at. Unlike HTML's<img>, this attribute is required.Value type:<length> |<percentage>;Default value:auto;Animatable:yes

href

Points at a URL for the image file.Value type:<URL>;Default value:none;Animatable:no

preserveAspectRatio

Controls how the image is scaled.Value type: (none |xMinYMin |xMidYMin |xMaxYMin |xMinYMid |xMidYMid |xMaxYMid |xMinYMax |xMidYMax |xMaxYMax) (meet |slice)?;Default value:xMidYMid meet;Animatable:yes

crossorigin

Defines the value of the credentials flag for CORS requests.Value type: [anonymous |use-credentials ]?;Default value: None;Animatable:yes

decoding

Provides a hint to the browser as to whether it should perform image decoding synchronously or asynchronously.Value type:async | sync | auto;Default value:auto;Animatable:yes

fetchpriorityExperimentalNon-standard

Provides a hint of the relative priority to use when fetching an external image.Allowed values:

high

Fetches the external image at a high priority relative to other external resources.

low

Fetches the external image at a low priority relative to other external resources.

auto

Doesn't set a preference for the fetch priority.It is used if no value or an invalid value is set.This is the default.

xlink:hrefDeprecated

Points at a URL for the image file.Value type:<URL>;Default value:none;Animatable:no

DOM Interface

This element implements theSVGImageElement interface.

Example

Basic rendering of a PNG image in SVG:

SVG

<svg width="200" height="200" xmlns="http://www.w3.org/2000/svg">  <image href="mdn_logo_only_color.png" height="200" width="200" /></svg>

Result

Specifications

Browser compatibility

See also

• fetchpriority attribute