The <strong><code>counter-set</code></strong> <a href="/en-US/docs/Web/CSS">CSS</a> property sets a <a href="/en-US/docs/Web/CSS/CSSCounterStyles/UsingCSScounters">CSS counter</a> to a given value. It manipulates the value of existing counters, and will only create new counters if there isn't already a counter of the given name on the element.

<pre class="brush: css notranslate"><code><span class="token comment">/ Set "my-counter" to 0 /</span> <span class="token property">counter-set</span><span class="token punctuation">:</span> my-counter<span class="token punctuation">;</span> <span class="token comment">/ Set "my-counter" to -1 /</span> <span class="token property">counter-set</span><span class="token punctuation">:</span> my-counter -1<span class="token punctuation">;</span> <span class="token comment">/ Set "counter1" to 1, and "counter2" to 4 /</span> <span class="token property">counter-set</span><span class="token punctuation">:</span> counter1 1 counter2 4<span class="token punctuation">;</span> <span class="token comment">/ Cancel any counter that could have been set in less specific rules /</span> <span class="token property">counter-set</span><span class="token punctuation">:</span> none<span class="token punctuation">;</span> <span class="token comment">/ Global values /</span> <span class="token property">counter-set</span><span class="token punctuation">:</span> inherit<span class="token punctuation">;</span> <span class="token property">counter-set</span><span class="token punctuation">:</span> initial<span class="token punctuation">;</span> <span class="token property">counter-set</span><span class="token punctuation">:</span> revert<span class="token punctuation">;</span> <span class="token property">counter-set</span><span class="token punctuation">:</span> unset<span class="token punctuation">;</span> </code></pre>

counter-set

The counter-set CSS property sets a CSS counter to a given value. It manipulates the value of existing counters, and will only create new counters if there isn't already a counter of the given name on the element.

Note: The counter's value can be incremented or decremented using the counter-increment CSS property.

Syntax

/* Set "my-counter" to 0 */ counter-set: my-counter;  /* Set "my-counter" to -1 */ counter-set: my-counter -1;  /* Set "counter1" to 1, and "counter2" to 4 */ counter-set: counter1 1 counter2 4;  /* Cancel any counter that could have been set in less specific rules */ counter-set: none;  /* Global values */ counter-set: inherit; counter-set: initial; counter-set: revert; counter-set: unset; 

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

Values

The name of the counter to set.

The value to set the counter to on each occurrence of the element. Defaults to 0 if not specified. If there isn't currently a counter of the given name on the element, the element will create a new counter of the given name with a starting value of 0 (though it may then immediately set or increment that value to something different).

No counter set is to be performed. This can be used to override a counter-set defined in a less specific rule.

Formal definition

Formal syntax

[ <counter-name> <integer>? ]+ | none
where <counter-name> = <custom-ident>

Examples

Setting named counters

h1 {   counter-set: chapter section 1 page;   /* Sets the chapter and page counters to 0,      and the section counter to 1 */ } 

Specifications

See also