Summary

The list-style-image property specifies an image to be used as the list item marker.

It is often more convenient to use the shorthand list-style.

  • Initial value none
  • Applies to list items
  • Inherited yes
  • Media visual
  • Computed value none or the image with its URI made absolute
  • Animatable no
  • Canonical order the unique non-ambiguous order defined by the formal grammar

Syntax

/* Keyword values */
list-style-image: none;

/* <url> values */
list-style-image: url('starsolid.gif');

/* Global values */
list-style-image: inherit;
list-style-image: initial;
list-style-image: unset;

Values

<uri>
Location of image to use as the marker.
none
Specifies that no image is used as the marker. If this value is set, the marker defined in list-style-type will be used instead.

Formal syntax

<uri> | none

Examples

View the live example

HTML Content

<ul>
    <li>Item 1</li>
    <li>Item 2</li>
</ul>

CSS Content

ul { list-style-image: url("https://developer.mozilla.org/samples/cssref/list-style/starsolid.gif") }

Specifications

Specification Status Comment
CSS Lists and Counters Module Level 3
The definition of 'list-style-image' in that specification.
Working Draft Extends support to any <image> data type.
CSS Level 2 (Revision 1)
The definition of 'list-style-image' in that specification.
Recommendation Initial definition.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 1.0 1.0 (1.7 or earlier) 4.0 7.0 1.0
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 1.0 1.0 (1) 6.0 6.0 1.0

See also

Document Tags and Contributors

Last updated by: Sebastianz,