The list-style-image CSS property sets an image to be used as the list item marker.
It is often more convenient to use the shorthand list-style.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Note: This property is applied to list items, i.e. elements with display: list-item;<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-typewill 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 value | none |
|---|---|
| Applies to | list items |
| Inherited | yes |
| Media | visual |
| Computed value | none or the image with its URI made absolute |
| Animation type | discrete |
| Canonical order | the unique non-ambiguous order defined by the formal grammar |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
list-style-image | Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1 | IE Full support 4 | Opera Full support 7 | Safari Full support 1 | WebView Android Full support 1 | Chrome Android Full support Yes | Firefox Android Full support 4 | Opera Android Full support 10.1 | Safari iOS Full support 1 | Samsung Internet Android Full support Yes |
Legend
- Full support
- Full support
See also
Document Tags and Contributors
Tags:
Contributors to this page:
ericwilligers,
mdnwebdocs-bot,
ddbeck,
mfluehr,
fscholz,
Arty-chan,
Sebastianz,
erikadoyle,
vanjacosic,
wizAmit,
SphinxKnight,
wbamberg,
ronakkhunt,
kscarfone,
teoli,
Sheppy,
ethertank,
McGurk,
grendel,
Alex Lakatos,
Jürgen Jeka,
Nathymig,
BijuGC,
DBaron,
Mgjbot,
Ptak82,
alecananian
Last updated by:
ericwilligers,