CSS list-style-image Property Reference

The CSS list-style-image property is a standard property in CSS Lists and Counters. Review its formal syntax, computed behavior, and practical declarations.

Updated 2026-08-12

list-style-image overview

The CSS list-style-image property is a standard property in CSS Lists and Counters. 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

list-style-image formal syntax

Field	Value
Formal syntax	<image> \| none
Initial value	none
Applies to	listItems
Inherited	Yes
Percentages	no
Computed value	theKeywordListStyleImageNoneOrComputedValue
Animation type	discrete
Media	visual
Specification group	CSS Lists and Counters
Status	Standard

Practical examples

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

list-style-image live example

CSS

.reset-example {
  list-style-image: initial;
}

.inherit-example {
  list-style-image: inherit;
}

@supports (list-style-image: initial) {
  .supported {
    list-style-image: initial;
  }
}