Skip to main content

What is a Theme Instance?

Written by Julian Rodrigues
Updated today

A Theme Instance is a customer-level configuration of a Theme, assigned to a Competition overlay. It defines how the graphics are set up for a particular output, allowing a single Competition to run multiple graphic configurations in parallel.


Understanding Themes vs Theme Instances

In LIGR Live, a Theme is the visual template that defines the overall look and feel of your graphics, including fonts, colours, layouts, and graphic styles. Themes are platform-level assets built by the LIGR team and assigned to your organisation. Customers do not edit Themes directly.


A Theme Instance is a customer-level configuration of an assigned Theme. It is applied at the Competition overlay level (Competition > Settings > Streams and Overlays > Overlay Settings), where you can tailor how that Theme is used for a specific output.


Think of it this way:


• The Theme is the master design, maintained by LIGR.


• The Theme Instance is how that design is configured and used for your broadcast.


[ Image placeholder: Theme Instance configuration page showing theme selection and settings ]


Why Theme Instances Matter

Theme Instances give your organisation flexibility in how graphics are produced and delivered. A Competition can have multiple overlays, and each overlay has its own Theme Instance and its own Automated Game Plan. Common reasons to use multiple Theme Instances include:


• Dual-stream broadcasting: run a full-graphics output for your media stream and a scoreboard-only output for a radar or IMG feed at the same time.


• Different outputs per destination: configure one Theme Instance for YouTube and another for a stadium screen.


• Customised graphic sets: control which graphics and playlists are available for each output.


• Competition-specific branding: apply the same base Theme across multiple Competitions with different sponsor setups or colour variations.


What You Can Configure in a Theme Instance

Each Theme Instance is configured independently at the overlay level. Typical configuration options include:


• Default graphics shown at match start


• The Automated Game Plan linked to the overlay (including Pre-Game, Live gameplay, and Post-Game sections, plus event-triggered playlists)


• Playlist priorities and behaviour for that overlay


• Advertising configuration, either Ad Set allocations for organisations using inbuilt themes, or playlist-based ads for organisations using Rive themes


• Branding and sponsor elements exposed by the assigned Theme


[ Image placeholder: Example of two overlays on a single Competition, each with its own Theme Instance, one full-graphics and one scoreboard-only ]


How Theme Instances Fit Into a Match

When you create a Match under a Competition, the Match inherits the overlays (and therefore the Theme Instances and Game Plans) configured for that Competition. If multiple overlays exist, each one produces its own graphics output, which can be sent to different destinations through separate streams.


This means a single Match can simultaneously produce:


1. A full broadcast output with scoring graphics, lower thirds, and full-screen graphics.


2. A scoreboard-only output showing just essential match data.


3. Any other custom output you have configured as an additional overlay.


Tips

• Start with a single overlay and Theme Instance when learning LIGR Live. Add more only when you have a clear use case, such as dual-stream delivery.


• Name your overlays and Theme Instances clearly (for example, "Media Stream" and "Scoreboard Only") so they are easy to identify.


• Changes made to a Theme Instance apply to all Matches in that Competition going forward, so test configurations before live use.


Common Issues

• Graphics not appearing on one output: check that the correct graphics and playlists are enabled within that specific Theme Instance and its Game Plan.


• Wrong configuration showing for a Match: confirm the Match is linked to the Competition with the expected overlay and Theme Instance setup.


• Scoreboard-only output missing graphics: ensure the overlay for that output has an Automated Game Plan with the appropriate playlists configured.

Did this answer your question?