Set up your data

TL;DR — Build structured data in two steps: create categories (the shape of your data), then add resources (the actual values). This is what your animations bind to.

#Before you start

You need:

A Quadraviz account
A Rive .riv file ready to upload

Start with our example file if you don't have one yet.

#Step 1 — Create your categories

A category is a template. It defines what fields a resource has and what type each field is. Think of it as a form blueprint.

Open the Quadraviz Controller.
Click the Resources tab.
Click + New category.
Name the category. Keep it descriptive — Player, not Stuff.
Click Next.

You can nest categories inside other categories. That's how you build structured types like a team made of five players.

#Example: a League of Legends roster

A Player category with:

Name (text)
Age (number)
Image

A Team category with:

Team name (text)
Logo (image)
Primary color (color)
Secondary color (color)
Five nested Player fields, one per role: Top, Jungle, Mid, ADC, Support

Create the child category first (Player), then the parent (Team). The parent references the child, so the child must exist.

#Step 2 — Add your resources

A resource is an actual data entry. One row of a category.

#Create the players

Open the Player category.
Click New Resource.
Fill in Name, Age, and Image.
Click Save.
Repeat for each player on the roster.

#Create the team

Open the Team category.
Click New Resource.
Fill in name, logo, and colors.
For each role field, select the matching Player resource you just created.
Click Save.

If a Player resource doesn't appear in the dropdown, double-check that you saved it. Resources only show up after they're created.

#Why this matters

Animations don't talk to spreadsheets. They talk to resources. Once your data is in Quadraviz, you can change a player's name once and every overlay using that resource updates.

#Next steps

Upload your Rive file — Bring your animation in
Resources overview — Go deeper on how resources work