Skip to main content

Manage card data with datasets

A dataset is a spreadsheet inside a game. Each row describes one game piece, and each column holds one kind of value used by those pieces.

A dataset with text, Enum, number, and colour columns, one row per card

Why use a dataset?​

Datasets separate content from layout. Instead of copying a card design and editing each copy, create one layout and bind it to rows. A wording change belongs in the dataset; a layout change belongs in the Designer.

TitleRulesCostArtworkFrame colour
Market DashMove two spaces.2market-dash.pngTeal
Late DeliveryDraw another card.1late-delivery.pngCoral

Create a useful dataset​

  1. Open Datasets and choose New dataset.
  2. Add a column for each value that changes between pieces.
  3. Choose the correct type for every column, including Enum for named variants.
  4. Add two or three representative rows.
  5. Open a design and assign this dataset.
  6. Bind layer fields to columns, then preview the test rows.

Name columns before binding a design. Clear names such as Title, Cost, and Artwork produce readable binding tokens and make the sheet easier to maintain.

Edit the grid​

Use the last row and column to add content. Select row or column headers for bulk actions, drag rows to reorder them, and right-click cells or headers for contextual actions. Each dataset tab has its own menu to rename, clone, move, or delete that dataset. The Shortcuts panel lists the current shortcuts; common defaults include:

  • Ctrl/Cmd + F to search.
  • Ctrl/Cmd + Shift + R for a new row.
  • Ctrl/Cmd + Shift + C for a new column.
  • Ctrl/Cmd + Z to undo the latest grid change.

Keep layout out of the data​

Store meaningful content in the dataset: names, rules, numbers, colours, images, and Enum choices. Keep coordinates, sizes, fonts, and visual effects in the Designer. This lets the same content support cards, tokens, references, and later layout revisions.

Dataset Export downloads a TSV spreadsheet. It does not export rendered pieces or back up the complete game. See Import and export data for the safe spreadsheet workflow.

Next: Choose column types, Enums, and images or import a spreadsheet.