Import Images to Dataset

The Import Folder of Images feature is a quick way to create a dataset from a collection of images. Instead of manually creating rows and typing in image references, you can automatically generate one row per image in a single click.

What It Does

This feature scans a folder from your game's uploaded images and creates a new dataset where:

Each image becomes one row
The row's name is set to the image filename
The row's quantity is set to 1
An image column is created with the proper template reference for each image

How to Use It

1 Upload Your Images

Before importing, make sure you've uploaded your images to your game. You can organize them into folders if desired.

2 Open the Import Menu

In the dataset editor, click the Import button in the toolbar and select Import Folder of Images.

3 Select a Folder

Choose which folder to import from. You can select "Root (no folder)" to import images that aren't in any folder, or select a specific folder name.

4 Preview

The dialog shows a preview of the images that will be imported, along with a count. Review the list to make sure you've selected the right folder.

5 Import

Click Next to see what will be changed, then click Import to complete the process.

Warning: This Replaces All Data

When you import a folder of images, all existing rows and columns in your dataset will be replaced. This action cannot be undone. Make sure you've exported a CSV backup if you need to preserve your current data.

What You Get

After importing, your dataset will have three columns:

Column Name	Column Type	Content
name	String	The image filename (e.g., "dragon", "sword-01")
quantity	Number	Set to 1 for each row
image	URL	A template reference like {{ images.dragon.url }}

Using the Imported Data

Once your images are imported, you can immediately use them in your design. The image column contains a properly formatted template that will resolve to the image URL.

Quick Tip

You can add more columns after importing! The image folder import gives you a starting point, but you're free to add additional columns for things like card text, stats, descriptions, or any other data you need.

Example Design Usage

In a layer's image source property, you could simply use:

This will display the correct image for each row as you page through your dataset.

Common Use Cases

Character Portraits: Import a folder of character images and add columns for names, stats, and abilities
Card Artwork: Import all your card illustrations, then add gameplay data in additional columns
Icon Sets: Import a collection of icons to use across multiple designs
Quick Prototyping: Get a bunch of placeholder images into a dataset fast, then refine later

Tips and Tricks

Organize Images First

Before importing, organize your images into folders. This makes it easier to import just the images you need for a specific dataset.

Use Descriptive Filenames

Since the image filename becomes the row name, use clear, descriptive names for your images. "card-01" is better than "img_1234".

Edit Quantities After Import

All rows start with quantity 1, but you can easily edit them afterwards if you need different quantities for different images.

Combine with Enumerations

After importing, you can add enumeration columns to create variations of each image. For example, add a frame column with values like "Gold,Silver,Bronze" to create multiple versions of each card.

Troubleshooting

Problem	Solution
The folder shows no images	Make sure you've uploaded images to that folder. Check that the files are valid image formats (PNG, JPG, etc.).
I imported the wrong folder	If you have a CSV backup, you can re-import your original data. Otherwise, you'll need to manually recreate your dataset or use the undo feature immediately after import.
The import button is grayed out	Make sure you've selected a folder that contains at least one image. Empty folders cannot be imported.
Images aren't showing in my design	Make sure the layer's image source property is set to {{row.image}}. Check that the template syntax is correct (double curly braces).

Summary

The Import Folder of Images feature is perfect when you have a collection of images and need to quickly create a dataset referencing them. It's a huge time-saver compared to manually creating rows and typing template references for each image.

Just remember that this import replaces all existing data, so use it either for new datasets or make sure you have a backup first!