counter-increment

The counter-increment CSS property increases or decreases the value of a CSS counter by a given value.

Note: The counter's value can be reset to an arbitrary number using the counter-reset CSS property.

Syntax

/* Increment "my-counter" by 1 */
counter-increment: my-counter;

/* Decrement "my-counter" by 1 */
counter-increment: my-counter -1;

/* Increment "counter1" by 1, and decrement "counter2" by 4 */
counter-increment: counter1 counter2 -4;

/* Do not increment/decrement anything: used to override less specific rules */
counter-increment: none;

/* Global values */
counter-increment: inherit;
counter-increment: initial;
counter-increment: revert;
counter-increment: unset;

The counter-increment property is specified as either one of the following:

A <custom-ident> naming the counter, followed optionally by an <integer>. You may specify as many counters to increment as you want, with each name or name-number pair separated by a space.
The keyword value none.

Values

<custom-ident>: The name of the counter to increment.
<integer>: The value to add to the counter. Defaults to 1 if not specified.
none: No counter must be incremented. This is used as the default value, or to cancel an increment in more specific rules.

Formal definition

Initial value	`none`
Applies to	all elements
Inherited	no
Computed value	as specified
Animation type	discrete

Formal syntax

[ <custom-ident> <integer>? ]+ | none

Examples

Incrementing named counters

h1 {
  counter-increment: chapter section 2 page;
  /* Increases the value of the chapter and page counters by 1,
     and the section counter by 2 */
}

Specifications

Specification
CSS Lists Module Level 3 (CSS Lists 3) # increment-set

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`counter-increment`	2	12	1	8	9.2	3	≤37	18	25	10.1	1	1.0