Upload File Attachments

  • Updated

You can include file uploads as a part of a Zingtree decision tree session. Some use cases include:

  • Attaching a screenshot.
  • Including a photo.
  • Uploading a document.


Using Data Entry Fields, you can pick the File Upload field type. This allows you to include one or more files in the session data gathered by Zingtree. When the end-user uploads a file, here’s what happens:

  1. The file is copied from the end-user’s computer to a Zingtree file storage server.
  2. Zingtree assigns a variable to the URL where the new file resides.

Security note: Each file uploaded has a random 7 digit prefix or session ID attached to it, so that files with the same name aren’t overwritten, and the file names cannot easily be discovered by hackers.

How It Works

When the end-user reaches a node with a file upload, they will see something like this:


Clicking Upload Document File allows them to choose a file on their computer. Once a file is chosen, the button changes:


How to Set up File Uploads

When editing a node, do the following:

  1. Go to Data Collection Form Fields, and select Add Form Field:


  2. Choose File as the field type, and enter a variable name and label for the upload button:



Secure Authenticated Downloads

After uploading a file, you can opt to create a link to it that is securely accessible via https and requires an agent login. The URL for this file would look like this:


The parameters:

  • var= is the name of the variable for the uploaded file URL.
  • session_id= is the session ID. You would insert #session?# to display this.

Uploading and Displaying Images

If you're uploading an image file, and want to display it on another node, here's a trick. As an example, if the image upload variable is image1, you would add an image placeholder with an id of image1. For this example, you would put this HTML code (using code view) into the node that displays the image:

<img id="image1" class="img-responsive">


Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Didn't find what you need?

Our friendly customer support team is here to help

Submit a Ticket

Looking for help or advice?

Reach out to our knowledgeable community of users.

Zingtree Community