---
description: v2.1.0 required
---

# 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](https://487176000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgpg8bODu8UEZd66d9q%2Fuploads%2FZnSMjGomO53CkAXubsqC%2FScreenshot%202021-10-28%20at%2012.42.40.png?alt=media\&token=66d240fe-2389-43d5-b9c1-96bd7026dfde)

## Text variables

H2R Graphics comes with 3 text variable slots which can be updated via our API.&#x20;

![Text variables in H2R Graphics](https://487176000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgpg8bODu8UEZd66d9q%2Fuploads%2Fe8XxZzukAGkVKD6ZhVcg%2FScreenshot%202021-10-28%20104033.jpg?alt=media\&token=7b8bd991-7b75-40f7-aa16-19265dc9fbce)

You can learn more about how to set these variables in our HTTP documentation.

{% content-ref url="../api/http" %}
[http](../api/http)
{% endcontent-ref %}

## Using variables

You can use variables in your graphics by using the following syntax:

`[text.1]`

![Using Text variables in a Lower Third graphic](https://487176000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgpg8bODu8UEZd66d9q%2Fuploads%2FARk2B2eLWcVvJ5BiBCxH%2FScreenshot%202021-10-28%20at%2012.35.31.png?alt=media\&token=f5961fa7-8791-428c-9c6e-1439ad316e1f)

## 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](https://487176000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgpg8bODu8UEZd66d9q%2Fuploads%2F63JdpvqifwntUCYVppdG%2FScreenshot%202021-10-28%20at%2012.41.48.png?alt=media\&token=e5f24b58-920e-4807-b831-ea81fa19f89b)

### 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](https://487176000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgpg8bODu8UEZd66d9q%2Fuploads%2FYQxSI06Uwfx40tdSpq3O%2FScreenshot%202021-10-28%20at%2012.46.26.png?alt=media\&token=02676f04-bd92-404d-a95d-db023446d190)

### Selecting data

Clicking the `👉` next to any row will update the variables for that list.

![Selecting a row on a list](https://487176000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgpg8bODu8UEZd66d9q%2Fuploads%2FmsuLTcxCi6JJv6g0uDxL%2FScreenshot%202021-10-28%20at%2012.47.43.png?alt=media\&token=6ff9f6b1-e537-4e3d-8710-e06f45511500)

### 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](https://487176000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgpg8bODu8UEZd66d9q%2Fuploads%2FJBeh2TZ5aNuRCRqwpbKd%2FScreenshot%202021-10-28%20at%2013.07.57.png?alt=media\&token=fa3eb569-ce31-44d0-a38d-c6a3bfd4a53e)

### Using any variable in a graphic&#x20;

You can use any variable in a list without selecting a row.

This can be done by using `[list1.row1.cell1]` for example.

![](https://487176000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgpg8bODu8UEZd66d9q%2Fuploads%2FXyrgp2OlzT8sVpoSjXMp%2FScreenshot%202022-06-01%20at%2009.44.09.png?alt=media\&token=a759842f-e50a-4d5b-8a9a-c77e1044cf7a)

In this example, we are capturing the data from List 1, Row 1, Cell 1.

![Selecting List 1, Row 1, Cell 1.](https://487176000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgpg8bODu8UEZd66d9q%2Fuploads%2F0GNuRnfaCJbufpTUqxri%2FScreenshot%202022-06-01%20at%2009.44.56.png?alt=media\&token=fc5164b4-1c8a-46fb-9f48-fe12323e9a06)

`[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](https://487176000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgpg8bODu8UEZd66d9q%2Fuploads%2FMeJdTWiqbE1KHCAFCxgp%2FScreenshot%202022-06-01%20at%2009.54.09.png?alt=media\&token=b26c2bec-ce32-4821-8bf0-ffb0ef4b4df7)

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](https://487176000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgpg8bODu8UEZd66d9q%2Fuploads%2FfZoByk6tHWfwBYYmDtmG%2FScreenshot%202022-06-01%20at%2009.54.48.png?alt=media\&token=6d37a5e8-cdbf-493f-abd0-450da616c9f8)

When you have created your .csv file, import that into H2R Graphics.
