Overview
FUSE expressions connect dynamic data from the LIGR platform to your Rive graphics. For each exposed input in your Rive file — text fields, image slots, number values — you can create expressions that pull live match data, player statistics, team information, and more. This allows your graphics to update automatically during broadcasts without manual data entry.
Expressions follow FUSE syntax and provide access to the full LIGR data hierarchy: league data, competition details, match information, team rosters, player statistics, and lineups. You can combine multiple data sources in a single expression using filters, formatting functions, and conditional logic.
Prerequisites
* A Rive file imported into FUSE with exposed inputs
* Understanding of which Rive inputs you want to bind data to
* Access to the FUSE graphics editor
Understanding the LIGR Data Hierarchy
FUSE provides access to a structured data hierarchy. At the top level, you have league and competition data. Below that, match data includes teams, scores, and status. Deeper levels provide access to player statistics, lineups, and detailed match events.
The hierarchy follows: League → Competition → Match → Teams/Players/Stats/Events.
When writing expressions, you navigate this hierarchy using dot notation to access the specific data fields you need.
How to Create Data Expressions for Rive Inputs
1. In the FUSE editor, select the Rive element that contains the input you want to bind data to.
2. Locate the exposed input in the properties panel on the right side of the screen.
3. Click in the expression field next to the input name.
4. Type your FUSE expression to reference the data you want to display.
5. Press Enter or click outside the field to save the expression.
6. Use the FUSE preview to verify the data displays correctly.
Common Data Expression Examples
Competition name:
Reference the competition name using the competition data object. This displays the name of the competition the match belongs to.
Team names:
Access home and away team names through the match data object. Use team name fields to display full team names in your graphic.
Match score:
Reference the current score for home and away teams. The score updates automatically as match events are logged.
Player statistics:
Use player data expressions to access individual player statistics including goals, assists, cards, and other match events.
Team logos:
For image inputs, reference team logo URLs from the team data object. The logo URL points to the uploaded team logo in Assets.
Using Formatting Functions in Expressions
FUSE provides formatting functions to modify how data displays:
* upper() converts text to uppercase
* Wrap an expression in upper() to display text in all capitals
* Formatting functions can be nested and combined with other expressions
Accessing Player Data
When using player variables in your graphic, access player information through the player.data object.
Player data includes:
* First name and last name
* Player number
* Team information
* Statistics (goals, tackles, shots, passes)
* Player image URL
The player variable creates a dropdown in the Control Room listing all available players. When an operator selects a player, all expressions referencing player.data update automatically to show that player's information.
Handling Missing Data
When a data field has no value, the expression returns a default based on the data type. Numerical statistics return 0 by default. Design your graphic to handle this gracefully — either by displaying 0 or by hiding the element when data is unavailable.
Testing Data Expressions
Use the FUSE preview to test your data expressions with live match data. The preview shows exactly how data will appear during a broadcast. Select different control variable options to verify expressions update correctly. Check that formatting displays as expected and that missing data is handled appropriately.
Combining LIGR Data with External Data
FUSE allows you to mix LIGR platform data with external data sources in the same graphic. External data from spreadsheets and APIs can be referenced alongside LIGR data expressions. This is useful for displaying information not available in the standard LIGR data model, such as tournament brackets or custom statistics.
Batch Updating Expressions
When you have multiple similar expressions to create, export your expressions as a text file, modify them in a text editor or using ChatGPT, then import them back into FUSE. This is particularly useful when creating repetitive expressions across multiple elements.
Publishing Graphics with Data Expressions
After configuring all data bindings, publish the graphic. In the Control Room, the graphic appears with all control variables ready for operator use. Use the preview function to verify data binding before going live. All expressions pull live data from the current match automatically.