CSS text-decoration Property Reference

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

Updated 2026-08-12

text-decoration overview

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

The property is not inherited by default. Use an explicit global keyword when inheritance is intended.

Syntax and formal definition

text-decoration formal syntax

Field	Value
Formal syntax	<'text-decoration-line'> \|\| <'text-decoration-style'> \|\| <'text-decoration-color'> \|\| <'text-decoration-thickness'>
Initial value	text-decoration-color, text-decoration-style, text-decoration-line
Applies to	allElements
Inherited	No
Percentages	no
Computed value	text-decoration-line, text-decoration-style, text-decoration-color, text-decoration-thickness
Animation type	text-decoration-color, text-decoration-style, text-decoration-line, text-decoration-thickness
Media	visual
Specification group	CSS Text Decoration
Status	Standard

Practical examples

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

text-decoration live example

CSS

.reset-example {
  text-decoration: initial;
}

.inherit-example {
  text-decoration: inherit;
}

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