Board Templates¶

Board templates let you automatically create recurring leaderboards on a schedule. Perfect for weekly challenges, monthly tournaments, or seasonal competitions.

When a template is active, LEADR automatically creates new boards at each interval. Previous boards are archived but remain viewable, preserving historical rankings.

Template ID¶

Each template has a unique identifier in the format tpl_<uuid>, for example: tpl_a1b2c3d4-e5f6-7890-abcd-ef1234567890.

Fields¶

Field	Required	Example	Default	Description
Name	Yes	`Monthly Challenge Boards`	-	Template name (used as fallback for board names)
Name Template	No	`{month_short} Challenge`	None	Template string with placeholders for dynamic board names
Slug	No	`monthly-challenge`	None	URL-friendly identifier for boards created from this template
Series	No	`monthly-challenge`	None	Identifier for sequential numbering (e.g., "weekly", "season")
Repeat Interval	Yes	`1 month`	-	How often to create boards (see format below)
Board Type	No	-	Per Player	Type of boards to create
Sort Direction	No	-	Descending	Sort direction for boards
Keep Strategy	No	-	Best	Keep strategy for Per Player boards
Icon	No	`fa-trophy`	fa-crown	FontAwesome icon for boards
Unit	No	`points`	None	Score unit label
Starts At	No	`2026-01-01T00:00:00Z`	None	Start time for created boards
Ends At	No	`2026-01-07T23:59:59Z`	None	End time for created boards
Tags	No	`monthly, challenge`	None	Tags for created boards
Active	Yes	-	-	Whether the template is currently active
Published	No	-	Yes	Whether created boards should be published

Repeat Interval Format¶

The repeat interval uses PostgreSQL interval syntax. Valid formats:

Interval	Example
Days	`7 days`, `14 days`
Weeks	`1 week`, `2 weeks`
Months	`1 month`, `3 months`
Years	`1 year`

Common intervals:

Weekly: 7 days or 1 week
Bi-weekly: 14 days or 2 weeks
Monthly: 1 month
Quarterly: 3 months
Yearly: 1 year

Name Template Placeholders¶

Use placeholders in the Name Template field to generate dynamic board names:

Placeholder	Output	Example
`{year}`	Four-digit year	`2026`
`{month}`	Full month name	`January`
`{month_short}`	Abbreviated month	`Jan`
`{week}`	ISO week number	`42`
`{quarter}`	Quarter of year	`Q1`
`{date}`	ISO date format	`2026-01-15`
`{series}`	Sequential number	`1`, `2`, `3`...

Sequential Series¶

The Series field enables sequential numbering for boards created from the same template:

Calculated dynamically: Series values are generated from existing board count + 1
Reuses numbers: If boards are deleted, their numbers become available again

To use series:

Set a Repeat Interval value
Set the Series field to an identifier (e.g., "weekly", "season", "pro_series")
Include {series} in your Name Template

Examples¶

Monthly High Scores¶

Creates a new board at the start of each month:

{
  "name": "Monthly High Scores",
  "name_template": "{month} High Scores",
  "repeat_interval": "1 month"
}

Generated boards: "January High Scores", "February High Scores", ...

Numbered Monthly Tournament¶

Creates numbered monthly tournaments:

{
  "name": "Monthly Tournament",
  "name_template": "Monthly Tournament #{series} - {month_short}",
  "repeat_interval": "1 month",
  "series": "monthly"
}

Generated boards: "Monthly Tournament #1 - Jan", "Monthly Tournament #2 - Feb", ...

Weekly Challenge¶

Creates weekly challenges numbered by ISO week:

{
  "name": "Weekly Challenge",
  "name_template": "Week {week} Challenge - {year}",
  "repeat_interval": "7 days"
}

Generated boards: "Week 1 Challenge - 2026", ..., "Week 52 Challenge - 2026", "Week 1 Challenge - 2027", ...

Quarterly Seasons¶

Creates seasonal boards each quarter:

{
  "name": "Seasonal Board",
  "name_template": "{year} {quarter} Season",
  "repeat_interval": "3 months"
}

Generated boards: "2026 Q1 Season", "2026 Q2 Season", "2026 Q3 Season", "2026 Q4 Season", ...

Pause a Template¶

To pause or disable a template and stop it from generating new boards:

Open the LEADR app and navigate to Games
Select your game and press t to open Templates
Select the template you want to pause
Press e to edit the template
Set Active to No
Save the template

The template will stop creating new boards until you set Active back to Yes. Existing boards created by the template are not affected.

See the Advanced Boards guide for more information on using board templates.

Need Help? The LEADR team and community is always happy to help on the LEADR Discord