`list-style` CSS property
The list-style CSS shorthand property allows you to set all the list style properties at once.
The list-style CSS shorthand property allows you to set all the list style properties at once.
CSS Demo: list-style
```css interactive-example-choice list-style: square;
```css interactive-example-choice
list-style: inside;
```css interactive-example-choice list-style: url("/shared-assets/images/examples/rocket.svg");
```css interactive-example-choice
list-style: none;
```css interactive-example-choice list-style: georgian inside url("/shared-assets/images/examples/rocket.svg");
```css interactive-example-choice
list-style: georgian outside url("/non-existent.svg");
```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: " ";
}
Constituent properties
This property is a shorthand for the following CSS properties:
- list-style-image
- list-style-position
- list-style-type
Syntax
/* type */
list-style: square;
/* image */
list-style: url("../img/shape.png");
/* position */
list-style: inside;
/* two values */
list-style: georgian outside;
list-style: url("img/pip.svg") inside;
/* three values */
list-style: lower-roman url("img/shape.png") outside;
/* Keyword value */
list-style: none;
/* Global values */
list-style: inherit;
list-style: initial;
list-style: revert;
list-style: revert-layer;
list-style: unset;
The list-style property is specified as one, two, or three values in any order. If list-style-type and list-style-image are both set, the list-style-type is used as a fallback if the image is unavailable.
Values
- list-style-type
- : A
<counter-style>, string, ornone. If omitted in the shorthand, it defaults todisc. See list-style-type. - list-style-image
- : An image or
none. If omitted, it defaults tonone. See list-style-image. - list-style-position
- : Either
insideoroutside. If omitted, it defaults tooutside. See list-style-position. none- : No list style is used.
Description
The list-style property lets you customize the appearance of list items. The values of this property are applied to list items, including li elements and elements with display: list-item;.
List style inheritance
Because the list-style-type longhand property is inherited, list-style can be set on a parent element (normally ol or ul) to make the same list styling apply to its list items. However, user-agent stylesheets set list-style-type on <ul>, <ol>, and menu elements, so nested lists use these default values instead of inheriting the ancestor list's list-style. The list-style-position and list-style-image values normally inherit into nested lists. To make nested lists inherit the marker type as well, set list-style or list-style-type to inherit on the nested list elements.
For example, in cases like this:
```html live-sample___list-style-inherit
- One
- Two
-
Three
- Four
- Five
- Six
Where a custom style is set on the outer list:
```css live-sample___list-style-inherit
body > ul {
list-style: square;
}
The inner list won't inherit the custom style unless you set it to inherit:
```css live-sample___list-style-inherit ul ul { list-style: inherit; }
100%
## Accessibility
Safari does not recognize ordered or unordered lists as lists in the accessibility tree if they have a `list-style` value of `none`, unless the list is nested within the nav navigation element. This [behavior is intentional](https://webkit.org/b/170179#c1) and is not considered a bug.
To ensure lists are announced as lists, include [`role="list"`](/docs/Web/Accessibility/ARIA/Reference/Roles/list_role) to ol and ul elements, especially if the list is not nested in a `<nav>`. This restores list semantics without affecting the design:
```html
<ul role="list">
<li>An item</li>
<li>Another item</li>
</ul>
If an ARIA role is not an option for your code, CSS can be used instead. Adding non-empty pseudo-content such as text or images before each list item can restore list semantics, but impacts the visual appearance. Safari determines if the added pseudo-content suffices as accessible content, restoring list semantics if so. Generally, Safari considers text and images as sufficient, which is why the content: "+ "; shown below works (but requires additional styling to not affect the design).
ul {
list-style: none;
}
ul li::before {
content: "+ ";
}
A declaration of content: ""; (an empty string) is ignored, as are content values that contain only spaces, such as content: " ";.
These CSS workarounds should only be used when an HTML solution is unavailable, and only after testing to ensure that they don't result in unexpected behaviors that may negatively impact user experience.
- 'Fixing' Lists (2023)
- VoiceOver and list-style-type: none (2017)
- Understanding WCAG: Create content that can be presented in different ways
- Understanding success criterion 1.3.1: Info and relationships | WCAG 2.1
Formal definition
Formal syntax
Examples
Setting list style type and position
HTML
List 1
<ul class="one">
<li>List Item1</li>
<li>List Item2</li>
<li>List Item3</li>
</ul>
List 2
<ul class="two">
<li>List Item A</li>
<li>List Item B</li>
<li>List Item C</li>
</ul>
CSS
.one {
list-style: circle;
}
.two {
list-style: square inside;
}
Result
auto
Specifications
Browser compatibility
See also
- Component properties: list-style-type, list-style-image, and list-style-position
- ::marker pseudo-element
- CSS lists and counters module
- CSS counter styles module