W3cubDocs

/Web APIs

HTMLLinkElement: sizes property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨January 2020⁩.

The sizes read-only property of the HTMLLinkElement interfaces defines the sizes of the icons for visual media contained in the resource. It reflects the <link> element's sizes attribute, which takes a list of space-separated sizes, each in the format <width in pixels>x<height in pixels>, or the keyword any.

It is only relevant if the rel is icon or a non-standard type like apple-touch-icon.

Value

A DOMTokenList

Examples

<link rel="icon" sizes="72x72 114x114" href="smallish.png" />

const link = document.querySelector("[rel=icon],[rel=apple-touch-icon]");
console.dir(link.sizes); /* output:
  DOMTokenList [ "72x72", "114x114" ]
    0: "72x72"
    1: "114x114"
    length: 2
    value: "72x72 114x114"
  */
console.log(link.sizes.value); // output: '72x72 114x114'
console.log(link.sizes.length); // output: 2'
console.log(link.sizes[0]); // output: '72x72'
console.log(link.sizes[1]); // output: '114x114'

Specifications

Specification
HTML>
# dom-link-sizes>

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
sizes
15Before Chrome 50, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList.
 79 31
15Before Opera 37, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList.
 6
18Before Chrome Android 50, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList.
 31
14Before Opera Android 37, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList.
 6
1.0Before Samsung Internet 5.0, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList.
4.4Before WebView 50, this property returned the deprecated child DOMSettableTokenList instead of DOMTokenList.
 6

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/HTMLLinkElement/sizes