Mozilla's getting a new look. What do you think? https://mzl.la/brandsurvey

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 valuenone
Applies tolist items
Inheritedyes
Mediavisual
Computed valuenone or the image with its URI made absolute
Animation typediscrete
Canonical orderthe 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

HTML

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

CSS

ul {
  list-style-image: url("https://mdn.mozillademos.org/files/11981/starsolid.gif")
}

Result

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: vanjacosic,