List

CSS list-style-image Property

Specifies an image to use as the list item marker

Syntax

CSS
list-style-image: none | <url>;

Values

ValueDescription
noneNo image marker (default)
url()Image URL for the marker

Example

CSS
ul.custom {
  list-style-image: url("/bullet.svg");
}

Understanding CSS list-style-image

The CSS list-style-image property specifies an image to use as the list item marker. As part of the List module in CSS, it is one of the most commonly used properties for controlling the visual presentation of web pages.

You can set list-style-image to values such as none, url(), among others. Each value changes how the browser renders the affected element, giving you fine-grained control over your page layout and design. Choosing the right value depends on the specific design requirements of your project.

Common use cases for the list-style-image property include responsive web design, component-based layouts, and creating visually consistent interfaces across devices. It works closely with related properties like list-style, list-style-type, content to achieve complex styling effects. Understanding how these properties interact helps you write cleaner, more maintainable stylesheets.

Browser support for list-style-image is excellent across all modern browsers including Chrome, Firefox, Safari, and Edge. For older browsers, consider using fallback values or progressive enhancement strategies. The property can also be set dynamically via JavaScript using element.style.listStyleImage or the CSS custom properties (variables) approach for theming.

Related Properties

Explore More CSS Properties

Browse our complete reference of 251 CSS properties with syntax, examples, and tips.