Variables
Variables in H2R Graphics is an easy way to use lots of data to update any of your graphics.
You can either use Text Variables or List Variables, we’ll explore both here.
![Variables in H2R Graphics](/assets/docs/variables-1.png)
Text variables
H2R Graphics comes with 3 text variable slots which can be updated via our API.
![Text variables in H2R Graphics](/assets/docs/variables-2.png)
You can learn more about how to set these variables in our HTTP documentation.
Using variables
You can use variables in your graphics by using the following syntax:
[text.1]
![Using Text variables in a Lower Third graphic](/assets/docs/variables-3.png)
List variables
List variables are another way to use dynamic text to update your graphics.
These lists are perfect when you have lots of messages to show, or quite a few lower thirds to display during a production.
![List of variables](/assets/docs/variables-5.png)
Data entry
Add all the data you need to the list, you can even change the table headings to suit your needs. By default they are set to; Name
, Company
, and Title
.
![Changing the title of a list column](/assets/docs/variables-4.png)
Selecting data
Clicking the 👉
next to any row will update the variables for that list.
![Selecting a row on a list](/assets/docs/variables-6.png)
Using list variables
Using data from your list is similar to Text variables from above.
Use [list1.1]
- for example - for the first list and the first column on the list.
![Adding List variables to a graphic](/assets/docs/variables-7.png)
Using any variable in a graphic
You can use any variable in a list without selecting a row.
This can be done by using [list1.row1.cell1]
for example.
![Using a specific list variable](/assets/docs/variables-9.png)
In this example, we are capturing the data from List 1, Row 1, Cell 1.
![Selecting List 1, Row 1, Cell 1](/assets/docs/variables-8.png)
[list1.row2.cell3]
would allow you to use “Intern” in any graphic.
Import CSV
You can import a CSV file into H2R Graphics to populate a variables list.
![Sample Google Sheet](/assets/docs/variables-10.png)
Use the first row to set the headings of your variables list, then the remainder of the CSV can be names, titles, companies etc.
Importing a CSV file
![Importing a CSV file](/assets/docs/variables-11.png)
When you have created your .csv file, import that into H2R Graphics.