You can decrease ambiguity for testers by providing screen shots and sample files. Inserting files gives testers a reference point to compare what they are seeing on the VM to a specific screenshot or use a file for some other reason so they may interact with it. 

Inserting screenshots or files to a test step

There are a few ways to upload a file into a Rainforest test. This article shows how to do it via the Rainforest app UI. See here on how to do it via the CLI. 

Embedding files 

  1. Ensure the test step is in edit mode. If not, click the pencil to edit the step.
  2. Drag a file from your file location onto the text field. You will see a + symbol when hovering over the text field.
  3. Once you drop the file, the file will be given a file number and enclosed by double braces {{}}.
  4. Click Save. The file name will convert into a gray box.

This will give testers a direct download link of the file provided! 

Provide a URL to the file

  1. Insert a step that links to the file on the hosting service
  2. Provide instructions to either download or use screenshot

     Open a new tab and go to [URL]
     Were you able to compare the image/downloaded the file?

Preview screenshot and download 

When a non-image file (.csv, .doc, .txt, etc.) is embedded, it will auto-format as a downloadable file {{,x)}} instead of a screenshot {{file.screenshot(x,x)}}. In the Test Edit view, the file will be clickable and will download directly from the test step.

Force image files to be downloadable files:

By default, images files (.jpeg, .png, .gif) are auto-formatted as a screenshot. If you wish for the tester to download the image, modify the file name in the text box.

Cannot force a downloadable file to be an image file.  
Cannot force an image file to be downloadable via a URL.

  1. Embed the file(s)and provide clear instructions on what to do with those files.
  2. Make the file downloadable, {{ file.screenshot(x,x) }}, by:
    replacing "screenshot" with "download",
    adding a comma and space,
    adding a name (can be anything but best to include original file type as well such as .png, jpg)

     Image  {{ file.screenshot(177510, nKcjvM) }}
     Downloadable {{, nKcjvM, file.png) }}

Opening and reading PDF files

Rainforest testers can open and view PDF files in Rainforest Virtual Machines through the PDF readers preinstalled on the VM.

Windows OS

All VMs that run a Windows operating system (OS), such as Chrome HD, Firefox HD, Internet Explorer 11 HD, etc. do have Adobe Acrobat Reader pre-installed and allow testers to open and view the PDF.


VMs that run on OSX, namely OSX Chrome (HD), OSX Firefox (HD), and Safari (HD) do not have a specific application dedicated to opening a PDF.

To open a PDF on one of these VMs, use the preinstalled Preview application that is capable of opening and viewing PDFs.

iOS Platforms

iOS devices have no preloaded applications for opening and viewing PDFs.

To view a PDF on one of these platforms, use the device's Safari browser which has PDF reading functionality.

Android Platforms

Android VMs have a PDF viewer installed. After testers download the PDF, it will automatically open and can be accessed in the "Files" app on the VM.

You may need to instruct testers to allow Chrome to access the device's photo, media, and files.

Did this answer your question?