MDN self-hosted library · e01.org

`list-style-image` CSS property

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

no runnable cells css-property upstream source

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