Skip to main content

How to Create a Theme Instance

Written by Julian Rodrigues
Updated today

A Theme Instance is a customer-level configuration of a Theme, assigned at the Competition overlay level. It controls the look and feel of the graphics used across that overlay's matches.


What Is a Theme Instance?

A Theme is the visual template that defines the design of your graphics. Themes are platform-level: they are built and maintained by the LIGR team, and then made available to your organisation.


A Theme Instance is your customer-level configuration of one of those Themes. It is assigned to a specific overlay within a Competition, with its own settings such as team colours, sponsor placements, and other configurable options exposed by the Theme.


You can think of it this way:


• A Theme is the master design, built by LIGR.


• A Theme Instance is your working copy, configured and assigned at the Competition overlay level.


One Theme can be used to create many Theme Instances, each tailored to a different Competition or overlay.


Because Theme Instances are assigned per overlay, a single Competition can have multiple overlays, each using its own Theme Instance and its own Automated Game Plan. This lets you run different visual configurations in parallel within the same Competition.


[ Image placeholder: Diagram showing one platform Theme being used to create multiple Theme Instances across different Competition overlays ]


Before You Start

Make sure you have the following ready:


• A Competition already created in your organisation


• A Theme available to your organisation (assigned by the LIGR team)


• Admin or Owner permissions to manage Competition settings


Creating a Theme Instance

Step 1: Open Your Competition

1. From the main navigation, go to Competitions.


2. Select the Competition you want to configure.


[ Image placeholder: Competitions list with one Competition highlighted ]


Step 2: Open Streams and Overlays

1. Inside the Competition, go to Settings.


2. Open Streams and Overlays, then Overlay Settings.


3. You will see each overlay configured for the Competition, along with any Theme Instance already assigned.


[ Image placeholder: Overlay Settings screen showing the overlays for a Competition ]


Step 3: Assign a Theme to an Overlay

1. Choose the overlay you want to configure.


2. Select a Theme from the list of Themes available to your organisation.


3. Confirm your selection to create the Theme Instance for that overlay.


[ Image placeholder: Theme selection panel showing a list of available Themes ]


Step 4: Configure the Theme Instance

Once the Theme Instance is created, you can configure it for this overlay. Depending on the Theme, the available options may include:


• Colours, toggles, and text values exposed by the Theme


• Competition-level branding


• Sponsor and advertising configuration (Ad Sets for inbuilt themes, or playlist-based ads for Rive themes)


• A preview of how the graphics will appear


[ Image placeholder: Theme Instance configuration screen with configurable options visible ]


Step 5: Save Your Changes

1. Review each setting in your Theme Instance.


2. Save your configuration.


The Theme Instance will now be used by every match that runs on this overlay within the Competition.


Tips

• Use descriptive Competition and overlay names so Theme Instances are easy to identify later.


• If you manage multiple Competitions that should look identical, assign the same Theme to each. Each Competition overlay gets its own Theme Instance you can fine-tune independently.


• If you need two visual configurations running in parallel (for example, a broadcast overlay and a venue overlay), add multiple overlays to the Competition and give each its own Theme Instance.


• Test a Theme Instance with a test match before running it on live games.


Common Issues

The Theme I want isn't showing in the list Themes are provisioned to your organisation by the LIGR team. If a Theme you expect is missing, contact LIGR support to confirm it has been made available.


My Theme Instance changes aren't appearing Make sure you have saved your changes. If a match was already loaded, you may need to reload it to pick up the new configuration.


Graphics look wrong after assigning a new Theme Different Themes expose different configuration options. Review the new Theme Instance and adjust settings such as team colours and sponsor allocations.


I changed a Theme Instance but other Competitions were affected Each Competition overlay has its own Theme Instance, so changes should be isolated to that overlay. If you are seeing changes across Competitions, confirm you are editing the correct Theme Instance and not a shared configuration.

Did this answer your question?