Getting Started With Screamscape
I spent about three weeks setting up my first Screamscape project after a colleague recommended it for a virtual tour we were building. The documentation is decent but scattered across multiple pages. Here's what I actually had to figure out through trial and error.
Screamscape A Rollercoaster Ride Of Digital Adventure Mapping The Virtual Frontier
First thing you need to do is create an account on their platform and verify your email. It's a browser-based tool, so there's nothing to download unless you want the desktop editor, which most people don't bother with. The free tier gives you three projects and a 500MB storage limit. If you're just testing the waters, that's enough. If you're planning something substantial, budget about $29 a month for the pro plan. The core workflow is straightforward. You import images or 360-degree photos, place hotspots on them, link those hotspots to other scenes, and publish. That's it. The editor handles the rest. Where people trip up is in the scene organization. I wasted two days because I didn't set up my folder structure before uploading assets. By the time I realized the platform was creating a flat hierarchy, I had 47 untagged images sitting in one directory. Start with a naming convention. I use YYYY-MM-DD_scene-number-description. It keeps everything findable when you come back to it weeks later. One thing the interface doesn't make clear is how the publishing pipeline works. When you hit publish, Screamscape renders your project into a self-contained HTML package that you can host anywhere. It doesn't force you to use their servers. That's actually a big deal. Most competitors lock you into their hosting. I hosted mine on a cheap DigitalOcean droplet for about five dollars a month. The load times were fine. PageSpeed insights gave me a 78 on mobile, which is acceptable for a virtual tour.
Here's a problem I ran into that took me forever to diagnose. My scenes were loading correctly on Chrome but completely white on Safari. I thought it was a certificate issue at first. Turns out it was the WebGL fallback. Screamscape defaults to WebGL2 for rendering, and older iOS devices just don't support it well. The workaround is to go into your project settings under Rendering Options and switch the compatibility mode to WebGL1. It adds a couple hundred milliseconds to scene transitions, but it fixes the blank screen issue entirely. I also discovered that wrapping your tour in an iframe on an HTTPS page caused some browsers to block the fullscreen functionality. Use a standalone URL if you can. For the actual content creation, you have two input paths. Import pre-made 360 photos or use the built-in asset library. The asset library is limited and mostly generic. I found it faster to take my own photos with a $150 Ricoh Theta camera and stitch them myself using PTGui before importing. The manual import gives you control over resolution and compression. Screamscape auto-compresses uploaded files, but it tends to overdo it on JPEGs. I recommend exporting at 85% quality before uploading to avoid double compression artifacts. The hotspot editor is where the tool really shows its age. You can add click zones, hot spots, info markers, and embedded media. The UI feels like it was designed in 2016 and never updated. There's no drag and drop for reordering hotspots within a scene. You have to delete and recreate them. I stopped caring after the fifth time and just worked around it by building scenes in order of complexity and never revisiting them.
Another counter-intuitive thing: you don't need high-resolution imagery for good results. Screamscape downsamples everything anyway. I tried a project with 8K panoramic photos and the final output looked identical to a 4K version, but the upload time was six times longer. Stick to 4K unless you're doing something print-oriented, which most people aren't. The export settings give you control over frame rate, texture quality, and audio bitrate. Frame rate defaults to 30fps and honestly there's no reason to bump it to 60 unless you're targeting a specific audience that complains about latency. Texture quality at medium looks indistinguishable from high on most screens. The one setting that matters is the progressive loading toggle. Keep it on. It loads scenes incrementally instead of waiting for everything to cache first. Projects without it feel sluggish on first visit. There are also some hidden gotchas with custom domain mapping. If you try to point a subdomain at your Screamscape tour, the SSL certificate provisioning fails half the time and you have to manually upload a certificate through their support portal. It works but adds two to three days of delay. I ended up just using their subdomain and putting a CNAME record on my main site that redirects to it. Clean, no certificate headaches.
Get the Full Details

If you're building something more ambitious, like an interactive narrative with branching paths, you'll quickly hit the limits of the visual editor. At that point the API comes into play, but it's undocumented beyond basic endpoints. I managed to pull scene data and automate hotspot insertion with a Python script, but it required reading through network traffic in DevTools to figure out the request format. They don't publish that stuff. The community is small. There's a Discord server with maybe two hundred active members and a forum that gets one or two useful replies per week. Most troubleshooting happens on Reddit or Stack Overflow in unrelated threads. I'd recommend keeping a personal knowledge base of whatever you learn. The platform changes features without announcement and the docs lag behind. Is it the best virtual tour platform out there? No. Feltz and EyeView offer better editing interfaces and more polished output. But Screamscape has one advantage that matters for certain use cases. It's faster to set up than anything else I've tried. A simple five-scene tour takes about twenty minutes from start to finish if you already have your images ready. For quick projects with tight deadlines, that speed is worth the rough edges.
The main downsides are the stagnant UI, the lack of real-time collaboration, and the absence of version control. If you're working in a team, you will fight the platform. I've seen two-person teams spend more time arguing over whose hotspot changes overwrote whose than actually building content. Solo workloads handle this tool fine. Group projects, look elsewhere. Also worth noting: Screamscape doesn't do video integration natively. You can embed YouTube or Vimeo links as hotspots, but they load as external iframes. That means your tour breaks if the user has ad blockers or if the embedded video service goes down. For a client project last year, I had to build a workaround using their API to pre-cache external media. It added a day of development but prevented a embarrassing demo failure. There's also the pricing model to consider. The per-project limit on the free tier is real. Once you exceed three projects, you either upgrade or you delete existing ones to make room. I've had to archive old tours to keep new ones active. It's not ideal but it keeps the cost down. If you're building a portfolio, the cost scales reasonably. Ten projects on the pro plan is still cheaper than most competitors' entry tiers.
I keep using this for small commercial projects because it gets the job done fast. It's not elegant and the support is slow, but for a virtual tour that needs to exist by Friday afternoon, it's hard to beat. If you need something more robust or have complex interactive requirements, Invest in a different tool. For most standard use cases though, Screapscape does what it promises without too much trouble.
