Adding images to your custom list items and schedule sessions is a great way to make your content stand out. You may have company logos for sponsors or headshots of your speakers, as examples.
You can manually add header images to your custom lists or schedule sessions in Builder. You can also manually add thumbnail images for your custom list items. However, this process may be time-consuming if you have quite a few images to add.
In this article, we will walk through using an import template to add images alongside your content.
Before Getting Started
Please make sure your images are sized properly.
- All images should be .PNG files
- Header images should be 640 pixels wide, 240 pixels tall
- Thumbnail images should be 240 pixels wide, 240 pixels tall.
If you import images that do not fit properly within these dimensions, Builder will try its best to fit them in your guide. However, your images may be distorted, cropped, or otherwise unusable if they are not properly sized beforehand.
Prepare Your Template
Add your data to a custom list template or schedule template like normal.
In a custom list template, you'll notice there is a column for your header images (“Image (Optional)”) and your thumbnail images (“Thumbnail (Optional)”). Please type in the exact filename for the image that should be imported. This is case-sensitive and there cannot be any spaces in the filename.
For a schedule template, you'll need to add a special column for your header images. To the right of all of your information, add a column called “Image Filename (Optional)”. Be sure to use this exact text or Builder will not be able to read the data.
Please type in the exact filename for the image that should be imported. This is case-sensitive and there cannot be any spaces in the filename. The filenames in your template should match the filenames of the images exactly.
Zip Your Image Files
Before importing your template and images to Builder, create a .zip file containing all of the images corresponding to your template for import. The .zip file should be less than <20 MB. If you have a lot of images, we recommend splitting up your template and images into segments and uploading them separately.
Please make sure you select the image files and zip them directly.
Do not zip the folder. You will get a "file type not found" error.
After compressing your images, your computer will create a .zip file with the images inside:
How to Create a .ZIP File
Windows: Highlight the files that you want to compress, and then right-click to open the menu. Select “Send to a Compressed (zipped) folder.”
macOS: Move all the files into a single folder. Click into that folder, highlight all the items, and then secondary click to pull up the menu. Select “Compress [x] items.”
Import Your Template and Zipped Image Files
Once you’ve created a .zip file, you can upload your template and images into Builder.
Whether you are importing a schedule template or custom list template, follow the steps in the linked articles to import your data.
After selecting your template spreadsheet, click Select ZIP file with images (optional) and select your .zip file. You will need to import your template and your .zip file simultaneously.
After selecting the file, review the two files you are uploading and click Import data:
Your files will upload to Builder, and then you can click Continue building.
Depending on how many images you are adding to your guide, this could take some time.
You will receive an email from Builder when the import is complete. If you see a “Success” message, refresh your page in Builder to check your data. If you see a “Whoops” message, check the error, make the changes Builder asks, and try again. You can view more information regarding errors in our support articles about the schedule and custom lists.