math.Counter

Returns a global counter value, incrementing it each time the function is called.

Syntax: math.Counter
Returns: uint64

The counter is global for both monolingual and multilingual projects, and its initial value for each build is 1.

layouts/page.html

{{ warnf "page.html called %d times" math.Counter }}

WARN  page.html called 1 times
WARN  page.html called 2 times
WARN  page.html called 3 times

Use this function to:

Create unique warnings as shown above; the warnf function suppresses duplicate messages
Create unique target paths for the resources.FromString function where the target path is also the cache key

Due to concurrency, the value returned in a given template for a given page will vary from one build to the next. You cannot use this function to assign a static id to each page.

Last updated: September 11, 2026 : content: Comply with function/method description guidance in style guide (76fa3fc9e)

Improve this page