This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.

The obsolete HTMLImageElement property border specifies the number of pixels thick the border surrounding the image should be. A value of 0, the default, indicates that no border should be drawn.

You should not use this property! Instead, you should use CSS to style the border. The border property or its longhand properties to not only set the thickness of the border but to potentially apply a wide variety of other styling options to it.

The width, specifically, is controlled using the writing-mode aware border-block-start-width, border-block-end-width, border-inline-start-width, and border-inline-end-width properties.

For compatibility (or perhaps other) reasons, you can use the older properties instead (or in addition): border-top-width, border-right-width, border-bottom-width, and border-left-width.


htmlImageElement.border = thickness;
let thickness = htmlImageElement.border;


A DOMString containing an integer value specifying the thickness of the border that should surround the image, in CSS pixels. A value of 0, or an empty string, indicates that there should  be no border drawn. The default value of border is 0

Usage notes

Do not use border. It is obsolete. Instead, use the CSS border property and its longhand properties to establish borders around images.

For example, if you have the following HTML:

<img src="image.png" border="2">

The following will provide the same appearance using CSS instead of this obsolete property:

<img src="image.png" style="border: 2px;">

You can further provide additional information to change the color and other features of the border:

<img src="image.png" style="border: dashed 2px #333388;">


Specification Status Comment
HTML Living Standard
The definition of 'HTMLImageElement.border' in that specification.
Living Standard
HTML 4.01 Specification
The definition of 'HTMLImageElement.border' in that specification.

Browser compatibility

Update compatibility data on GitHub
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
borderChrome Full support 1Edge Full support 12Firefox Full support YesIE ? Opera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android ? Safari iOS Full support YesSamsung Internet Android Full support Yes


Full support  
Full support
Compatibility unknown  
Compatibility unknown