Batch Add Images to Product Builder

Product Builder allows you the ability to showcase a preview of the image your customers are building, as they build it. You can upload images for this preview manually, or in bulk/in batches.


As of February 19th, 2021, Product Builder is unavailable for new installations. If you are currently using Product Builder, you will be able to continue using the app as your account will now be grandfathered.



Before attempting the bulk image import, it is recommended calculating the total number of image scenarios. To do this, simply multiply the number of options within each step together.


Step 1: 8 options

Step 2: 3 options

Step 3: 9 options

Step 4: 5 options

8 x 3 x 9 x 5 = 1,080 image previews

If your possible number of image scenarios is over 100,000, the bulk image import will not work properly.

Please contact our Merchant Success team if you have any questions, or if your possible number of image scenarios reaches 10,000.

Before you can batch import your images, you will need to upload and host them first. We recommend uploading them to your Shopify Store.

  1. From the Shopify admin, select Settings.


  2. Select Files.


  3. Select Upload files.

    Upload Files

  4. Select the files you would like to upload.

    Select Files

  5. Select Open.


  6. View the File URLs.

    Note: Your URLs will look something like this: XXXX and YYYY are identifiers for your Shopify store and you will need them later. ZZZZZ is a timestamp, however, and you will not need this information.

    File URL

  1. Create a New Product Builder Page.
  2. Add Conditions to Your Product Builder.
  3. Assign Images to Your Product Builder.

    Note: On Step 6, once you have received the email to let you know the image scenarios have generated, follow these steps instead.

  4. Select Export Builder.

    select export builder

  5. Select a Product Builder to export.

    choose the product builder to export

  6. Select Export Product Builder.

    Note: You will receive an email with the export files once the export is complete. When you receive this email, you can continue with Step 7.

    export product builder

  7. Select the link to download the file.

    select the link to download the file

  8. Select Show in folder to view the file.

    select show in folder

  9. Right-click on the file and select Extract All.

    select extract all

  10. Select Extract.

    select extract

  11. Open builder_scenarios.csv and builder_scenarios_images.csv.

    open the csv files

  12. Copy Columns A, B, and C from builder_scenarios.csv.

    copy the columns

  13. Insert three columns as Column A, B, and C in builder_scenarios_images.csv.

    insert columns

  14. Paste the copied columns into the newly created columns.

    paste columns

  15. In the Order Id column, enter 1 in all used rows.

    enter 1

  16. Enter the URL to the corresponding image for each scenario. The URL will be the first part of the URL mentioned in step 1 ( An image called image1.jpg would have a complete URL of

    Note: You will need to refer to the Scenario Key column within the builder_scenarios CSV to understand which image URL goes in which cell.

    enter the url

  17. Select Save.
  18. Create a new ZIP file from these files by selecting and then compressing using the option in the right-click menu. The extract must contain only the .CSV files.
  19. Within the Product Builder app admin, select Import Builder.

    select Import Builder

  20. Select Choose File.

    Select Choose File

  21. Select Import Product Builder.

    Select Import Product Builder

Was this article helpful?
0 out of 1 found this helpful