HTMLLinkElement: blocking property

Limited availability

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

The blocking property of the HTMLLinkElement interface is a string indicating that certain operations should be blocked on the fetching of an external resource.

It reflects the blocking attribute of the <link> element.

Value

A string. Must be a space-separated list of blocking tokens listed below indicating the operations that are to be blocked:

render: The rendering of content on the screen is blocked.

Note: Only link elements in the document's <head> can possibly block rendering. By default, a link element with rel="stylesheet" in the <head> blocks rendering when the browser discovers it during parsing. If such a link element is added dynamically via script, you must additionally set blocking = "render" for it to block rendering.

Examples

html

<link
  id="el"
  rel="stylesheet"
  href="/example.css"
  blocking="render"
  crossorigin />

const el = document.getElementById("el");
console.log(el.blocking); // Output: "render"

Specifications

Specification
HTML # dom-link-blocking

Browser compatibility

Help improve MDN

Learn how to contribute

This page was last modified on ⁨Aug 13, 2025⁩ by MDN contributors.

View this page on GitHub • Report a problem with this content