list-style-position

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

The list-style-position CSS property sets the position of the ::marker relative to a list item.

Try it

Syntax

css
/* Keyword values */
list-style-position: inside;
list-style-position: outside;

/* Global values */
list-style-position: inherit;
list-style-position: initial;
list-style-position: revert;
list-style-position: revert-layer;
list-style-position: unset;

The list-style-position property is specified as one of the keyword values listed below.

Values

inside

The ::marker is the first element among the list item's contents.

outside

The ::marker is outside the principal block box. This is the default value for list-style.

Description

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.

If a block element is the first child of a list element declared as list-style-position: inside, then the block element is placed on the line after the marker-box.

It is often more convenient to use the shorthand list-style.

Formal definition

Initial valueoutside
Applies tolist items
Inheritedyes
Computed valueas specified
Animation typediscrete

Formal syntax

list-style-position = 
inside |
outside

Examples

Setting list item position

HTML

html
<ul class="inside">
  List 1
  <li>List Item 1-1</li>
  <li>List Item 1-2</li>
  <li>List Item 1-3</li>
  <li>List Item 1-4</li>
</ul>
<ul class="outside">
  List 2
  <li>List Item 2-1</li>
  <li>List Item 2-2</li>
  <li>List Item 2-3</li>
  <li>List Item 2-4</li>
</ul>
<ul class="inside-img">
  List 3
  <li>List Item 3-1</li>
  <li>List Item 3-2</li>
  <li>List Item 3-3</li>
  <li>List Item 3-4</li>
</ul>

CSS

css
.inside {
  list-style-position: inside;
  list-style-type: square;
}

.outside {
  list-style-position: outside;
  list-style-type: circle;
}

.inside-img {
  list-style-position: inside;
  list-style-image: url("star-solid.gif");
}

Result

Specifications

Specification
CSS Lists and Counters Module Level 3
# list-style-position-property

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
list-style-position
inside
outside

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

See also