Template Variables

Variables are placeholders in your template text that Teamarr replaces with real data when generating EPG. They use curly-brace syntax:

{team_name} vs {opponent} at {venue}
→ "Detroit Lions vs Chicago Bears at Ford Field"

Teamarr provides 194 variables across 17 categories covering everything from team identity and scheduling to odds, standings, combat sports, and more.

Syntax

Wrap any variable name in curly braces and place it anywhere in a title, subtitle, description, or artwork URL field:

{variable_name}

Variables are case-sensitive and must match the names in the reference exactly. Unknown variable names are left as-is in the output, so a typo like {Team_Name} will appear literally rather than being substituted.

Suffix system

Team templates support suffixes to reference games other than the current one:

Suffix	What it refers to	Example
(none)	The current game	`{opponent}`
`.next`	The next upcoming game	`{opponent.next}`
`.last`	The most recently completed game	`{opponent.last}`

Suffixes are only available in team templates. Event templates exist for a single game, so .next and .last have no meaning there and are not supported.

Not every variable supports all three suffixes. The full variable reference shows which suffixes are available for each variable in the Suffixes column, using:

base — no suffix (current game)
.next — next game
.last — last game

Team templates vs event templates

Team templates
Event templates

Team templates power channels that exist 24/7 for a specific team (e.g., “Detroit Lions”).

Content is shown from the team’s perspective
Supports .next and .last suffixes
Includes filler content (pregame, postgame, idle) using the same variable syntax
Variables like {team_name}, {team_record}, {streak} are relative to the tracked team

Title:       {team_name} {vs_at} {opponent}
Description: The {team_name} ({team_record}) {vs_at} {opponent} ({opponent_record}) at {venue}.
             {today_tonight_title}'s game airs on {broadcast_network}.

Event templates power channels that are created dynamically for each game and disappear when the game ends.

Content is positional — home team vs away team, not team-specific
No suffix support needed (each channel covers exactly one event)
No filler content (no channel exists when there is no game)
Variables like {home_team}, {away_team}, {home_team_record} are used instead of {team_name}

Title:       {away_team} @ {home_team}
Description: {away_team} ({away_team_record}) at {home_team} ({home_team_record}).
             {home_team} is a {odds_spread} favorite.

The 17 variable categories

Category	What it covers	Example variables
Identity	Team names, abbreviations, league, sport	`{team_name}`, `{opponent}`, `{matchup}`, `{league}`
Date & Time	Game scheduling and relative day labels	`{game_date}`, `{game_time}`, `{relative_day}`, `{days_until}`
Venue	Stadium name and location	`{venue}`, `{venue_city}`, `{venue_full}`
Home/Away	Positional team references and home/away context	`{home_team}`, `{away_team}`, `{is_home}`, `{vs_at}`
Records	Win-loss records for team and opponent	`{team_record}`, `{opponent_record}`, `{home_record}`
Streaks	Current winning and losing streaks	`{streak}`, `{win_streak}`, `{opponent_streak}`
Scores	Game scores and result details	`{score}`, `{final_score}`, `{score_diff}`, `{winner}`
Outcome	Win/loss indicators and overtime	`{result}`, `{result_text}`, `{overtime_text}`
Standings	Playoff seed and games back	`{playoff_seed}`, `{games_back}`, `{opponent_playoff_seed}`
Statistics	Points per game averages	`{team_ppg}`, `{team_papg}`, `{opponent_ppg}`
Playoffs	Season type indicators	`{season_type}`, `{is_playoff}`, `{is_regular_season}`
Odds	Betting lines when available	`{odds_spread}`, `{odds_moneyline}`, `{odds_over_under}`
Broadcast	TV and streaming networks	`{broadcast_network}`, `{broadcast_simple}`, `{is_national_broadcast}`
Rankings	College rankings (NCAAF, NCAAM, NCAAW)	`{team_rank}`, `{team_rank_display}`, `{is_ranked_matchup}`
Conference	Conference and division for pro and college leagues	`{pro_conference}`, `{pro_division}`, `{college_conference}`
Soccer	Competition context for teams that play in multiple leagues	`{soccer_match_league}`, `{soccer_primary_league}`
Combat Sports	UFC/MMA event-specific variables	`{event_title}`, `{fighter1}`, `{card_segment_display}`

Usage examples

The examples below show a template string and the rendered output.

Team template — pregame
Event template — pregame
Postgame filler
UFC event template

Template:

Title:       {team_name} {vs_at} {opponent}
Description: The {team_name} ({team_record}) host the {opponent}
             ({opponent_record}) at {venue}. {today_tonight_title}'s
             game airs on {broadcast_network}.

Rendered output (Detroit Lions channel):

Title:       Detroit Lions vs Chicago Bears
Description: The Detroit Lions (10-4) host the Chicago Bears
             (8-6) at Ford Field. Today's game airs on FOX.

Template:

Title:       {away_team} @ {home_team}
Description: {away_team} ({away_team_record}) at {home_team}
             ({home_team_record}). {home_team} is a {odds_spread} favorite.

Rendered output:

Title:       Chicago Bears @ Detroit Lions
Description: Chicago Bears (8-6) at Detroit Lions (10-4).
             Detroit Lions is a -3.0 favorite.

The .last suffix references the most recently completed game. This is useful for postgame filler on team template channels:Template:

Title:       {team_name} Postgame
Description: The {team_name} {result_text.last} the {opponent.last}
             {final_score.last} {overtime_text.last}.

Rendered output (Detroit Lions channel):

Title:       Detroit Lions Postgame
Description: The Detroit Lions defeated the Minnesota Vikings 28-21.

Combat sports variables are event-only and do not use suffixes:Template:

Title:       {event_title} - {card_segment_display}
Description: {matchup}. Main card at {main_card_time}.
             {bout_count} total bouts.

Rendered output:

Title:       UFC 314: Volkanovski vs Lopes - Main Card
Description: Alex Volkanovski vs Diego Lopes.
             Main card at 10:00 PM EST. 14 total bouts.

Next steps

See the Full Variable Reference for a complete table of all 194 variables organized by category, including available suffixes and sample output for each.

Template Variables

Supported Leagues

Data Providers

Architecture & Deployment

Template Variables

Template Variables

Syntax

Suffix system

Team templates vs event templates

The 17 variable categories

Usage examples

Next steps

Build docs developers (and LLMs) love

Template Variables

Supported Leagues

Data Providers

Architecture & Deployment

​Template Variables

​Syntax

​Suffix system

​Team templates vs event templates

​The 17 variable categories

​Usage examples

​Next steps

Build docs developers (and LLMs) love

Template Variables

Syntax

Suffix system

Team templates vs event templates

The 17 variable categories

Usage examples

Next steps