Variable reference

Every variable, field, and error message on one page, for looking things up.

New to variables? Start with Variables, then Advanced variables. This page assumes you know both.

Shape

{{ [stage.S.] [lobby.L.] [match.M.] rank.N | slot.N | mvp.N … field }}

Prefixes are optional and must stay in this order.
All numbers start at 1. Matches go up to 16.
lobby.L switches to all matches unless match.M follows it.
Scores under stage.S need lobby.L.

Where each variable can go

Place	Accepts
Text box	Any text variable, mixed with words
Table	One variable: `data_row.N`, a row source, then one field per column. See Table map
Image	Exactly one logo or flag variable, nothing else
Discord message	Any text variable (web dashboard only)

Event and date

Variable	Value
`{{event.name}}`	Event name
`{{date}}`	UTC date of the run, `dd/mm/yyyy`. The images and the shared message use the same date.

Stage, lobby, and match

Use the plain form for the run you generated, or add numbers, such as {{stage.1.name}}, {{stage.1.lobby.2.size}}, or {{match.3.label}}.

Variable	Value
`stage.number`	Stage number
`stage.name`	Stage name
`stage.lobby_count`	Lobbies in the stage
`lobby.number`	Lobby number
`lobby.name`	Lobby label
`lobby.size`	Seats per lobby for the stage
`lobby.team_count`	Teams on the lobby’s scoring tab
`match.number`	Match number, blank for all matches
`match.label`	`All matches` or `Match M`

Rank and slot fields

rank.N is the team in Nth place. slot.N is the team in slot N. Both take the same fields.

Field	Value	Works in
`rank`	Standings rank	Text, table, message
`slot`	Slot number	Text, table, message
`name`, `tag`	Team name and tag from the scoring sheet	Text, table, message
`country`	Registered country	Text, table, message
`wins`	Chicken dinners	Text, table, message
`kills`	Total team kills	Text, table, message
`placement_points`	PP	Text, table, message
`kill_points`	KP	Text, table, message
`total_points`	PP + KP	Text, table, message
`matches_played`	Matches with a recorded placement. All matches only	Text, table, message
`logo`	Team logo	Image
`flag`	Team country flag	Image

Player fields

rank.N.player.R or slot.N.player.R, where R is the scoring-sheet roster row, 1–8.

Field	Value	Works in
`name`	In-game name	Text, message
`kills`, `damage`	Player totals	Text, message
`position`	P1–P4, S1–S2. Rows 1–6 only	Text, message
`country`	Registered country. Rows 1–6 only	Text, message
`flag`	Country flag. Rows 1–6 only	Image

MVP fields

mvp.N is Nth in kill order.

Field	Value	Works in
`rank`	MVP rank	Text, table, message
`name`	Player name	Text, table, message
`kills`, `damage`	Player totals	Text, table, message
`country`	Player’s country	Text, table, message
`flag`	Player’s flag	Image
`team.name`, `team.tag`, `team.rank`, `team.slot`, `team.country`	The MVP’s team	Text, table, message
`team.logo`, `team.flag`	The MVP’s team logo and flag	Image

The underscore forms team_name, team_tag, team_rank, team_slot, team_country, and team_logo are the same as their dotted versions and keep working.

Table map

{{data_row.D | [stage.S.] [lobby.L.] [match.M.] rank.N | slot.N | mvp.N | field | field | …}}

data_row.D: the table row to start filling, counting header rows.
Row source: what the first filled row shows. Each row below is the next rank, slot, or MVP.
Fields: one per column, left to right. Rank and slot tables take the rank and slot text fields. MVP tables take the MVP text fields, including team.name.
Player, logo, and flag fields are not allowed. Generated rows cannot have merged cells.

Common errors

Message gist	What to check
Unknown variable / malformed variable syntax	Spelling, missing braces, prefixes out of order, or a field that is not listed above
Unsupported rank, player, or MVP field	The field exists, but not there. For example, a logo in a text box
No configured alt-text variables	Variables are in visible text instead of Description, or on the wrong tab
Image must contain exactly one logo variable	Description has extra text around the variable
Image must use a logo or flag variable	An image has a text variable, such as a name
Selects stage S without a lobby	Add `lobby.L` after `stage.S`
Uses matches_played for one match	Only use it for all-matches results, or add a `lobby.L` prefix without a match
Scoring sheets stop at match 16	Use a match number from 1 to 16
Results for stage S, lobby L … are not loaded	A label points at a lobby the slide shows no scores for. Add a score variable for that lobby, or check the numbers
No scoring sheet tab exists / no longer exists	Run `/sheets update` so every referenced lobby has a tab
Stage or lobby no longer exists	The number points past the event’s stages or lobbies
Table must begin with data_row.N	The first piece inside the braces is `data_row.N`
Table needs a rank, slot, or MVP row source	The second piece is `rank.N`, `slot.N`, or `mvp.N`, with any prefix in front
Field must be a bare field name	Write `name`, not `rank.1.name`. Prefixes go on the row source
Field is not allowed for rank, slot, or MVP rows	Player, logo, and flag fields cannot go in tables. MVP tables use MVP fields
Table has an empty field	A stray or doubled `\|`
Table maps X columns, but has Y	One field per column, no more, no fewer
Table starts at row N, but has only M rows	Lower `data_row.N` or add rows to the table
Merged cells in generated rows	Unmerge data rows; headers may stay merged
Discord message uses image data	Remove logo and flag variables from the message
Over Discord’s 2,000 character limit	Shorten the message. The limit counts filled-in values
Results expired	Generate again, then share