Skip to main content

Customer file upload in Lantern quizzes

Written by Wendy

If you prefer, you can check out this information in video format.

The file upload feature allows customers to upload images, videos, and documents directly within the quiz. Storage is not limited per store. The number of files per page is set by Max. Files (20 by default), and each file can be up to 5 GB.

Where to Find the File Upload Feature

You can add the file upload widget in the following pages of your quiz:

  • Question Pages – Allows quiz takers to upload files as part of their responses.

  • Transition Screens – Collect additional media before moving to the next question.

  • Results Page – Provide an option for users to upload files for further evaluation or follow-up.

  • Opt-in Pages – Capture additional user information by allowing quiz takers to upload files along with their email, phone number, or name.

Adding a File Upload Widget on a Quiz Page

The File Upload Widget is available on any quiz page by using Add a Content Block button to add extra content and you can add it in any of the sections where the button is available.

Image showing three locations on any page where the “Add Content Block” button appears, highlighting areas where you can insert additional elements like a file upload widget.

To start adding a File Upload Widget you need to click Add Content Block and in the block you can enable the Include a file upload widget.

Image showing the content block settings with the “Include a file upload widget” option enabled.

Once you tick Include a file upload widget, you can set Max. Files, the maximum number of files you want to allow anyone to upload on this page. The widget's text is shown in the quiz's language, which you set in the quiz's language settings. In our example we can use a limit of 5 files to be uploaded.

Image showing file upload settings with options to choose the language and set a maximum number of files you want to allow anyone to upload on this page.

Once you click Save Content Block you can test the functionality in the quiz editor. The element will look and act as you would expect it to do live. You can upload files to test what happens once you reach the number set in Max. Files. When the limit is reached, the box shows Maximum number of files reached and no more files can be uploaded.

Image showing the file upload widget after reaching the upload limit, with the “Add more” button no longer visible in the top right corner.

The upload process is easy and straightforward for customers as they can drop files into the widget, which reads Drop files here or browse, or click browse to choose them. They can upload multiple files, including images, videos, documents, or any other type of files you may need to collect.

Image showing the drag-and-drop file upload interface with the option to browse files to add their files in the widget.

Each file starts uploading as soon as it is dropped or picked. It shows its upload progress, then Uploaded when it is done.

Image showing a file being uploaded with a visible progress bar and confirmation on completion.

Adding a File Upload Widget on the Results Page

The File Upload Widget is available on the Results page by using Add a Dynamic Content Block and you can add it in any of the areas where the button is available.

Image showing the “Add a Dynamic Content Block” button on the Results Page.

To start adding a File Upload Widget, you need to click Add a Dynamic Content Block and in the block you can enable the Include a file upload widget.

Image showing Dynamic Content Block settings with the file upload widget enabled.

Once you tick Include a file upload widget, you can set Max. Files, the maximum number of files you want to allow quiz takers to upload. The widget's text is shown in the quiz's language, which you set in the quiz's language settings.

In our example we can use a limit of 3 files to be uploaded. We can customize this Dynamic Content Block to introduce the fact that people can share a picture of their pet to win a special surprise upon the community’s upvote on the photos submitted. This can be an incentive for them to share content that you can use to engage with your audience and use personalized dynamic text to better convert the upload rate. Once this is done click Save Content Block then preview and test.

Image showing a customized Dynamic Content Block promoting a pet photo upload with limited file uploads and personalized text.

Similar to adding this widget on a quiz page you can test it either in the Preview mode, at the end of a quiz submission, or in the quiz builder.

To better see the impact of this element for customers we can use the Preview mode and let’s upload a max of 3 files.

Image showing a results page with a customized file upload widget with multiple files added and the upload limit reached.

Each file starts uploading as soon as it is dropped or picked. It shows its upload progress, then Uploaded when it is done.

Image showing the upload progress for three files in the Results Page preview.

Viewing and Managing Uploaded Files

Admins can access uploaded files in the Reporting section:

  • Sessions – A new "Uploaded Files" column provides a link to view and download files submitted during a quiz session. Clicking this link redirects you to the Uploaded Files Section.

Image showing the “Sessions” report with an “Uploaded Files” column linking to view submitted files.

  • Submissions – Similar to Sessions, this section includes an "Uploaded Files" column that links to the Uploaded Files Section for tracking and managing uploaded content.

Image showing the “Submissions” report with a link to access uploaded files from quiz participants.

  • Uploaded Files Section – A dedicated area where admins can view and download all files uploaded by quiz takers. This section provides a centralized view of all uploaded media.

Image showing the Uploaded Files section on the Reporting tab where all submitted files can be viewed and downloaded.

  • Filtering by session – Click View files (N) on a row in Sessions or Submissions to open Uploaded Files filtered to that session. The filter is shown as a Session badge that you can remove. Otherwise, the page lists every upload in the store, newest first.

Image showing how to filter uploaded files by session ID in the Uploaded Files section of the Reporting tab.

To pull uploaded files into your own system automatically, use the Files API.

Important Notes

  • File Upload is not available on all Lantern legacy plans. File upload is included in the Grow, Enterprise and custom legacy plans, and in all current plans. If this feature is not available to you, please check your Billing dashboard for more information.

  • Storage and file limits – Storage is not limited per store. The number of files per page is set by Max. Files (20 by default), and each file can be up to 5 GB.

  • Language Support – The file upload interface supports multiple languages.

This feature enhances the quiz experience by enabling users to submit media files for deeper engagement and personalized recommendations. If you need assistance setting up file uploads, feel free to reach out to our support team.

Did this answer your question?