`text-decoration-skip-ink` CSS property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It's been available across browsers since March 2022.

The text-decoration-skip-ink CSS property specifies how overlines and underlines are drawn when they pass over glyph ascenders and descenders.

text-decoration-skip-ink is not part of the text-decoration shorthand.

Try it

text-decoration-skip-ink: auto;

text-decoration-skip-ink: none;

<section id="default-example">
  <p>
    <span class="transition-all" id="example-element">parapsychologists</span>
  </p>
</section>

p {
  font:
    1.9em "Georgia",
    serif;
  text-decoration: underline;
}

Syntax

/* Single keyword */
text-decoration-skip-ink: none;
text-decoration-skip-ink: auto;
text-decoration-skip-ink: all;

/* Global keywords */
text-decoration-skip-ink: inherit;
text-decoration-skip-ink: initial;
text-decoration-skip-ink: revert;
text-decoration-skip-ink: revert-layer;
text-decoration-skip-ink: unset;

Values

This property is specified as one of the following keyword values:

none

Underlines and overlines are drawn across the full length of the text content, including parts that cross over glyph descenders and ascenders.

auto

The default — the browser may interrupt underlines and overlines so that they do not touch or closely approach a glyph. That is, they are interrupted where they would otherwise cross over a glyph.

all

The browser must interrupt underlines and overlines so that they do not touch or closely approach a glyph. This can be helpful with certain Chinese, Japanese, or Korean (CJK) fonts, where the auto behavior might not create interruptions.

An example of "text-decoration-skip-ink".

Formal definition

Initial value	auto
Applies to	all elements
Inherited	yes
Computed value	as specified
Animation type	discrete

Formal syntax

text-decoration-skip-ink = 
  auto |
  all |
  none

Examples

HTML

<p>You should go on a quest for a cup of coffee.</p>
<p class="no-skip-ink">Or maybe you'd prefer some tea?</p>
<p>この文は、 text-decoration-skip-ink: auto の使用例を示しています。</p>
<p class="skip-ink-all">
  この文は、 text-decoration-skip-ink: all の使用例を示しています。
</p>

CSS

p {
  font-size: 1.5em;
  text-decoration: underline blue;
  text-decoration-skip-ink: auto; /* this is the default anyway */
}

.no-skip-ink {
  text-decoration-skip-ink: none;
}

.skip-ink-all {
  text-decoration-skip-ink: all;
}

Result

Specifications

Specification
CSS Text Decoration Module Level 4 # text-decoration-skip-ink-property

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
`text-decoration-skip-ink`	64	79	70	50	15.4	64	79	46	15.4	9.0	64	15.4
`all`	148	148	75	132	15.4 If the `unicode-range` descriptor applies to the font, then some text decoration may not be skipped (see bug 255159).	148	79	99	15.4 If the `unicode-range` descriptor applies to the font, then some text decoration may not be skipped (see bug 255159).	No	148	15.4 If the `unicode-range` descriptor applies to the font, then some text decoration may not be skipped (see bug 255159).
`auto`	64	79	70	51	15.4 If the `unicode-range` descriptor applies to the font, then some text decoration may not be skipped (see bug 255159).	64	79	47	15.4 If the `unicode-range` descriptor applies to the font, then some text decoration may not be skipped (see bug 255159).	9.0	64	15.4 If the `unicode-range` descriptor applies to the font, then some text decoration may not be skipped (see bug 255159).
`none`	64	79	70	51	15.4	64	79	47	15.4	9.0	64	15.4