Upload an HTML prototype to a study
Usability tests
Intercept studies
AI moderated studies
Not every prototype lives in Figma, and not every prototype is ready to be published to a public URL. If you've got an HTML prototype—something you've built with AI or something that lives on your own computer—you can upload it to your study for use in task questions. Dscout hosts the file for you, so there's nothing to deploy and no share link to manage.
Uploads sit alongside the other two task stimulus options: Website and Figma prototype. A single task question can use one of the three, not a combination.
Supported file types
You can upload either a single .html file or a .zip containing a whole static site.
File types
.html, .htm, or .zip
File size
25 MB or smaller
Unzipped size
100 MB or smaller
Files in a zip
500 or fewer
Inside a zip file, you can include pages (.html, .htm), stylesheets (.css), images (.png, .jpg, .jpeg, .gif, .webp, .avif, .svg, .ico, .bmp), fonts (.woff, .woff2, .ttf, .otf), and media (.mp4, .webm, .mp3, .wav).
Prepare an HTML file
Your prototype has to be completely self-contained. It can't load anything from the internet while a participant is using it. A few things to check before you upload:
Use relative paths. Paths that start with a forward slash (
/) won't work.Bundle every asset. Images, fonts, and stylesheets all need to be inside a single zip file. A hosted web font or a CDN link will be turned away.
Include an entry page. Your zip file needs either an
index.htmlat the top level, or exactly one.htmlfile at the top level.Point forms inward. A form that submits somewhere outside your upload won't work.
Upload an HTML file
You can upload an HTML file at the study level or from inside a task question. Either way, once a prototype is in your study, you can reuse it across as many task questions as you like.
To upload at the study level:
On the Usability test/Study/AI moderator tab of your study, click the Task stimuli button in the top right corner. The task stimuli management modal is displayed.

Click + Add task stimuli. Then, select Upload HTML.

Locate and select your .html, .htm, or .zip file. Then, click Open.
You'll see a progress bar while Dscout reviews your file. Keep the tab open until the upload finishes.

When the check passes, your prototype appears in the list with its filename and file size.

Click Done.
To upload from a task question:
While editing your task question, click Add beside Task stimuli. Then, select Upload HTML.

Locate and select your .html, .htm, or .zip file. Then, click Open.
You'll see a progress bar while Dscout reviews your file. Keep the tab open until the upload finishes.

When the check passes, click Done.
Preview an uploaded file
You have to preview an uploaded prototype and confirm it before you can launch your study. This is a required step to make sure what participants see is what you meant to upload.
On the uploaded prototype, click the Preview (eye) icon. The Preview uploaded file modal is displayed. (To open it in its own tab instead, click the Open in new tab icon.)

Click through your prototype and check it looks and behaves the way you expect.
Click Looks good.

Now, you're ready to finish building your study.
If you head to launch before confirming your upload, you'll see a validation telling you to confirm the prototype. Click the validation to preview the prototype directly—you don't need to return to the relevant question.
Convert a prototype with AI
If you run into an issue uploading a prototype, there's probably something in your prototype that isn't supported, typically JavaScript. However, many interactions can be rebuilt using only HTML and CSS, which are both supported.
Here's a breakdown of some common prototype interactions and how well they can be reproduced without JavaScript:
Moving between screens
✅ Yes
Each screen becomes its own page, connected by links.
Tabs, accordions, and dropdown menus
✅ Yes
CSS techniques and built-in HTML elements reproduce behavior.
Pop-ups and modals
✅ Yes
A link opens a section styled as a modal.
Hover effects, transitions, and animations
✅ Yes
CSS techniques.
Image carousels
🟡 Partly
CSS-only carousel, without auto-advance timers.
Filling out and submitting a form
🟡 Partly
Participants can type, but the form can't submit. The "Submit" button becomes a link to a confirmation page.
Search, filters, and sorting
🟡 Partly
Pre-built result pages for a few example choices.
Logins, carts, and anything that remembers input
❌ No
Show example states as separate pages rather than user-specific inputs (for example, a cart with two items in it).
Live data, drag and drop, randomized content, and timers
❌ No
Replace with static example content.
If the above trade-offs work for your study, you can convert your existing prototype.
To convert your prototype:
Export or download your prototype files from the tool where you built it.
In an AI tool like Claude or ChatGPT, attach the exported files and send the following prompt:
Your AI tool will respond with a feasibility report, describing each interaction in your prototype that needs rebuilding as well as how it will be rebuilt.
Reply to your AI tool to confirm.
Now, your prototype is converted to a version that only uses HTML and CSS. Test it on your computer to ensure it works as needed, then upload it to your Dscout study following the steps in Upload an HTML file.
What participants see
Participants open your prototype inside Dscout, the same way they would a masked task URL. A few things worth knowing:
Task URL masking is always on for an uploaded prototype (and can't be disabled). Participants never see a URL for your file. For more on masking, see Mask task URL.
Your prototype isn't public. Only participants in your study can open it, and they won't be able to access it again once they've finished the study.
Clicks are captured just like any other task (though heat maps are not generated). Click data shows up in analysis labeled by page (
index.html,checkout.html, and so on). For more information, see Analyze heat maps and click data.
Manage uploaded prototypes
Every prototype you've uploaded lives in the Task stimuli manager, alongside your website and Figma links. Each one shows its filename, file size, and the questions it's attached to.

To reuse a prototype: click Add beside Task stimuli on any task question, then pick the prototype from Previously added. One upload can serve as many questions as you need.
To remove a prototype from a single question: click the Delete (trash) icon on the prototype in that question. The file stays in your study for reuse elsewhere.
To delete a prototype entirely: open the Task stimuli manager and click the Delete (trash) icon beside it. If it's attached to any questions, you'll get a confirmation first.
Troubleshooting
If your HTML upload doesn't pass, Dscout tells you exactly what went wrong and where. Here's what each message means and how to fix it.
Contains JavaScript (<script>)
Remove the script tags. Uploaded prototypes support HTML and CSS only.
Uses inline JavaScript event handlers
Remove onclick, onload, and similar attributes.
Contains a javascript: link
Replace it with a normal link to a page in your upload.
Uses an element that isn't allowed
Remove any iframe, embed, object, base, or meta refresh tags.
Contains an SVG with scripts, animation, or embedded styles
Re-export the SVG without scripting or animation, or swap it for a PNG.
Loads something from outside the file
Download the web font, CDN file, or image and include it in your zip.
Has a form that submits outside the file
Point the form at a page inside your upload, or remove the action.
References a path starting with /
Switch to relative paths.
References a file that isn't in the upload
Add the missing file, or fix the path.
Embeds a data: resource of a type that isn't allowed
Only images and fonts can be embedded this way.
Includes a file type that isn't supported
Remove it. .js files are the most common cause.
Has no index.html, and no single HTML page to open
Add an index.html, or reduce to one top-level HTML file.
Is larger than 25 MB
Compress your images, or trim unused files.
Is larger than 100 MB when unzipped
Compress your images, or trim unused files.
Contains more than 500 files
Remove anything the prototype doesn't need.
Contains file paths that aren't allowed
Re-zip without .. in any path.
Contains symbolic links
Re-zip with the real files instead of shortcuts.
Couldn't be read
Your zip file may be damaged, password-protected, or saved in an unusual format. Re-zip and try again.
Couldn't be checked
Something went wrong on our end. Try uploading again.
Other things you might run into:
Your upload finished, but nothing changed
Your new file is identical to the one already attached to your task question, so there was nothing to swap. Make sure you're using the correct file and are looking at the intended task question.
You can't launch
A prototype still needs confirming. Preview it, ensure it works as expected, then click Looks good.
"There is nothing to preview for this upload yet"
The file is still being checked, or it didn't pass.
A participant lands back at the start of your prototype
Long sessions refresh the prototype periodically, which returns participants to the entry page.