W3cubDocs

/Web APIs

CanvasRenderingContext2D: imageSmoothingQuality property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The imageSmoothingQuality property of the CanvasRenderingContext2D interface, part of the Canvas API, lets you set the quality of image smoothing.

Note: For this property to have an effect, imageSmoothingEnabled must be true.

Value

One of the following:

"low"

Low quality.

"medium"

Medium quality.

"high"

High quality.

The default value is "low".

Examples

>

Setting image smoothing quality

This example uses the imageSmoothingQuality property with a scaled image.

HTML

<canvas id="canvas"></canvas>

JavaScript

const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");

let img = new Image();
img.src = "canvas_create_pattern.png";
img.onload = () => {
  ctx.imageSmoothingQuality = "low";
  ctx.drawImage(img, 0, 0, 300, 150);
};

Result

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
imageSmoothingQuality 54 79 No 41 9.1 54 No 41 9.3 6.0 54 9.3

See also

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/imageSmoothingQuality