The counter-reset
CSS property resets a CSS counter to a given value.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Note: The counter's value can be increased or decreased using the counter-increment
CSS property.
Syntax
/* Set "my-counter" to 0 */ counter-reset: my-counter; /* Set "my-counter" to -1 */ counter-reset: my-counter -1; /* Set "counter1" to 1, and "counter2" to 4 */ counter-reset: counter1 1 counter2 4; /* Cancel any reset that could have been set in less specific rules */ counter-reset: none; /* Global values */ counter-reset: inherit; counter-reset: initial; counter-reset: unset;
The counter-reset
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 reset 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 reset.
<integer>
- The value to reset the counter to on each occurrence of the element. Defaults to
0
if not specified. none
- No counter reset is to be performed. This can be used to override a
counter-reset
defined in a less specific rule.
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
Resetting named counters
h1 { counter-reset: chapter section 1 page; /* Sets the chapter and page counters to 0, and the section counter to 1 */ }
Specifications
Specification | Status | Comment |
---|---|---|
CSS Lists Module Level 3The definition of 'counter-reset' in that specification. | Working Draft | No change. |
CSS Level 2 (Revision 1)The definition of 'counter-reset' in that specification. | Recommendation | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
counter-reset
|
Chrome
Full support 2 |
Edge
Full support 12 |
Firefox
Full support 1 |
IE
Full support 8 |
Opera
Full support 9.2 |
Safari
Full support 3 |
WebView Android
Full support ≤37 |
Chrome Android
Full support 18 |
Firefox Android
Full support 25 |
Opera Android
Full support 10.1 |
Safari iOS
Full support 1 |
Samsung Internet Android
Full support 1.0 |
Legend
- Full support
- Full support
See also
- Using CSS Counters
counter-increment
counter-set
@counter-style
counter()
andcounters()
functionscontent
property
counter-reset by Mozilla Contributors is licensed under CC-BY-SA 2.5.