`list-style-image` CSS property
The list-style-image CSS property sets an image to be used as the list item marker.
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.
CSS Demo: list-style-image
```css interactive-example-choice list-style-image: url("/shared-assets/images/examples/rocket.svg");
```css interactive-example-choice
list-style-image: none;
```html interactive-example
NASA Notable Missions
- Apollo
- Hubble
- Chandra
- Cassini-Huygens
- Spitzer
```css interactive-example
.default-example {
font-size: 1.2rem;
}
#example-element {
width: 100%;
background: #be094b;
color: white;
}
section {
text-align: left;
flex-direction: column;
}
hr {
width: 50%;
color: lightgray;
margin: 0.5em;
}
.note {
font-size: 0.8rem;
}
.note a {
color: #009e5f;
}
@counter-style space-counter {
symbols: "\1F680" "\1F6F8" "\1F6F0" "\1F52D";
suffix: " ";
}
[!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 value */
list-style-image: none;
/* <url> values */
list-style-image: url("star-solid.gif");
/* valid image values */
list-style-image: linear-gradient(to left bottom, red, blue);
/* Global values */
list-style-image: inherit;
list-style-image: initial;
list-style-image: revert;
list-style-image: revert-layer;
list-style-image: unset;
Values
This property is specified as a single value from the following list:
- image
- : A valid 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. This is the default value for list-style.
Formal definition
Formal syntax
Examples
Using a url value
This example has a star as a marker, which we include using the <url> image function.
HTML
<ul>
<li>Item 1</li>
<li>Item 2</li>
</ul>
CSS
ul {
list-style-image: url("star-solid.gif");
}
Result
Using_a_url_value
Using a gradient
This example has a CSS gradient as a marker, which we create uses the linear-gradient() image function.
HTML
<ul>
<li>Item 1</li>
<li>Item 2</li>
</ul>
CSS
ul {
font-size: 200%;
list-style-image: linear-gradient(to left bottom, red, blue);
}
Result
Using_a_gradient
Specifications
Browser compatibility
See also
- list-style shorthand
- list-style-type property
- list-style-position property
- ::marker pseudo-element
- CSS lists and counters module
- CSS counter styles module