CSS text-underline-offset Property Reference

The CSS text-underline-offset property is a standard property in CSS Text Decoration. Review its formal syntax, computed behavior, and practical declarations.

Updated 2026-08-12

text-underline-offset overview

The CSS text-underline-offset property is a standard property in CSS Text Decoration. Review its formal syntax, computed behavior, and practical declarations.

The computed value normally inherits from the parent element when no declaration wins the cascade.

Syntax and formal definition

text-underline-offset formal syntax

Field	Value
Formal syntax	auto \| <length> \| <percentage>
Initial value	auto
Applies to	allElements
Inherited	Yes
Percentages	referToElementFontSize
Computed value	asSpecified
Animation type	byComputedValueType
Media	visual
Specification group	CSS Text Decoration
Status	Standard

Practical examples

These declarations demonstrate valid ways to set text-underline-offset. The initial and inherit global keywords remain available even when a property-specific value is preferable.

text-underline-offset live example

CSS

.reset-example {
  text-underline-offset: initial;
}

.inherit-example {
  text-underline-offset: inherit;
}

@supports (text-underline-offset: initial) {
  .supported {
    text-underline-offset: initial;
  }
}