The list-style-image CSS property specifies an image to be used as the list item marker. It is often more convenient to use the shorthand list-style.

Note: This property is applied to list items, i.e. elements with display: list-item; by default this includes <li> elements. Because this property is inherited, it can be set on the parent element (normally <ol> or <ul>) to let it apply to all list items.

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

<url>
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

<url> | none

Example

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 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

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

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic supportChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support 4Opera Full support 7Safari Full support 1WebView Android Full support 1Chrome Android Full support YesEdge Mobile Full support 12Firefox Android Full support 4Opera Android Full support 6Safari iOS Full support 1Samsung Internet Android Full support Yes

Legend

Full support  
Full support

See also

Document Tags and Contributors

Last updated by: ddbeck,