CSS list-style-image

The CSS list-style-image property is used to specify an image to be used as a list marker's default contents.

The list-style-image property allows you to create your own custom bullets to use in lists.

The list-style-image property can be used on any list item. A list item is any element with its display property set to list-item or inline-list-item. List items are the only elements that generate ::marker pseudo-elements.

Also see the list-style, list-style-type and list-style-position properties.

Syntax

Possible Values

none

The default contents of the of the list item's marker are given by list-style-type instead.

image

Specifies an image as the default contents of the list item's marker. Must be a valid image, otherwise the default contents will be provided by list-style-type instead.

In addition, all CSS properties also accept the following CSS-wide keyword values as the sole component of their property value:

initial

Represents the value specified as the property's initial value.

inherit

Represents the computed value of the property on the element's parent.

unset

This value acts as either inherit or initial, depending on whether the property is inherited or not. In other words, it sets all properties to their parent value if they are inheritable or to their initial value if not inheritable.

General Information

Example Code

Official Specifications

• CSS Lists and Counters Module Level 3 (W3C Working Draft)
• CSS Level 2.1 (W3C Recommendation 07 June 2011)
• CSS Level 1 (W3C Recommendation 17 Dec 1996)