Upload your first Gaussian Splat scene
Kroscloud turns a Gaussian Splatting capture — a photoreal scan made with a phone app or a desktop program — into a fast, interactive web scene that runs in any modern browser. Once it's uploaded you can add points of interest with audio, anchor it to real-world GPS, let visitors measure it (with a reference mesh), protect it with a password, and then share it with a single link or embed it in your own website. This guide takes you from your splat file to your first live scene.
Splat file formats you can upload
Kroscloud accepts the five common splat file formats. Upload whichever your tool exports — Kroscloud optimizes every upload automatically, and your original file is archived untouched at full quality, so improved delivery formats can be produced later without a re-upload.
| Format | Where it comes from | Good to know |
|---|---|---|
PLY .ply |
The standard export of most desktop splat tools (Postshot, Nerfstudio, SuperSplat editor). | Lossless but large — often hundreds of MB. Fine to upload; Kroscloud compresses it for delivery. |
SPZ .spz |
Scaniverse and other Niantic-ecosystem tools. | Compact (typically around 10× smaller than the equivalent PLY) — a good choice when your PLY is over the size limit. |
SOG .sog |
SuperSplat editor and the PlayCanvas ecosystem. | Very compact. Also the format Kroscloud itself serves to visitors. |
splat / ksplat .splat .ksplat |
Various web viewers and converters. | Older web formats — supported for convenience; prefer PLY/SPZ/SOG when you have the choice. |
Size & performance
.spz or .sog instead; if it is over the splat limit, crop
the capture in the SuperSplat editor or upgrade. Large files are sent in pieces and retried automatically
if your connection drops — just keep the tab open until the upload finishes.
Don't worry about making the file small for your visitors — that part is automatic. Kroscloud compresses every upload (~80% smaller in our tests) and prepares it two ways: a full-detail version that shows every splat you uploaded, loaded once and crisp from the first frame — used for most scenes — and a streaming version for very large scenes, lighter devices and browsers without WebGPU, which starts quickly and sharpens as the visitor explores. The viewer picks the right one for each visitor's device automatically — see Full detail and streaming for how it decides and which splat count to aim for if your visitors use phones and tablets.
Upload your splat scene, step by step
1. Start a new splat scene
Sign in and open My board. Click Create new scene, then choose 3D Splat Scene to open the splat upload page.
2. Choose your file
Select your splat file — or drag and drop it onto the page. Kroscloud reads the file header and shows what it found on the spot: the file size, the splat count and whether it fits your plan, for every supported format. There's no 3D preview at this step; you'll see your scene rendered right after processing.
3. Name it and save
Give your scene a title (you can change it any time), an optional description, choose whether it's private, and pick a folder. Click Save — the upload finishes and you're back on My board immediately.
4. Let Kroscloud optimize it
Your new scene appears on the board as a Processing tile. In the background Kroscloud validates the file, compresses it, prepares it for streaming, renders a thumbnail and frames an opening camera view. The tile switches to ready by itself — small scenes take a few minutes, the largest captures with tens of millions of splats around half an hour. No need to keep the page open.
5. Make it interactive
Open the finished scene in the editor. The first time, Kroscloud asks you to confirm the scene's orientation (flip it upright if the capture came in sideways) — do this first, before adding points. Then bring it to life: add points of interest (including 360° panoramic points that teleport visitors into a panorama and back), attach an audio guide, anchor it to GPS coordinates, and set the starting camera view.
Add measurement, height profiles and contour lines
A splat has no solid surface of its own, so measuring on it needs a reference mesh: a
.glb of the same scene that Kroscloud keeps invisible and uses only as the surface the tools measure
on. Once it's uploaded, visitors get the same distances, height profiles and contour lines as on
any Kroscloud 3D model scene. Uploading the reference mesh needs a Premium plan or higher (it also
makes clicks land exactly on the surface); measurement, height profiles and contour lines are
Business features. The steps below are the quick version;
Collider mesh explains which tools give you a mesh that lines
up, how to prepare it, and what changes for your visitors.
1. Export a mesh from the same project
The mesh must come from the same project or capture as your splat so both share position and
scale — export it from the same RealityScan or 3DF Zephyr project as the splat, or
export a mesh of the same capture from Scaniverse, Polycam or
KIRI Engine (convert it to .glb if the app exports another format). Decimate it
heavily and strip textures, then export as .glb — in metres, uncompressed.
.glb file with its data embedded
and uncompressed (no Draco or mesh quantization). The hard limit is 100 MB and 10 million
triangles, but a mesh anywhere near that will make your scene slow to open.
2. Upload it in the Collider mesh menu
Open your splat scene in the editor and choose Collider mesh. Click Upload collider mesh (.glb) and pick your file. While the menu is open the mesh is drawn as a wireframe over the splat, so you can check that they line up (it disappears again when you close the menu). If the mesh comes in rotated, turn it with the rotate buttons (90° steps about X, Y or Z) — this fixes the usual axis mismatch between tools without a re-export. You can replace or download the mesh from the same menu at any time.
3. Switch Measurement on
Open the Measurement menu and turn measurement on. Set Model Unit to the unit your mesh was exported in — metres for most photogrammetry and capture tools. If the scene is georeferenced with all three GPS points, you can enable Use GPS distances to scale measurements from the georeference instead. Visitors can now measure distances, read height profiles and add contour lines on your splat.
What you can build next
Uploading the splat is just the start. The interactive presentation features that power Kroscloud's 3D model scenes work directly on your capture:
- Points of interest with audio — clickable hotspots with text, images, YouTube videos or a spoken audio guide, placed by clicking directly on the splat.
- Panoramic points — drop visitors into a 360° view and back into the splat, combining drone-scale capture with ground-level detail.
- Georeferencing — on-site visitors see their live GPS position inside your capture.
- Measurement, height profiles & contour lines — upload a reference mesh and visitors measure on the splat as on a 3D model scene (Business).
- Protected scenes — lock client work behind a password or secret access links.
- Scene analytics — see views, engaged time and which points visitors opened, cookie-free.
When it's ready, share or embed your scene anywhere — the embed works like a YouTube video: one iframe snippet on your own website.
Troubleshooting
| Problem | What to do |
|---|---|
| It won't accept my file | Only .ply, .spz, .splat, .ksplat and .sog are supported — and the .ply must be a Gaussian Splat PLY exported by a splat tool. A regular 3D-scan point cloud saved as .ply won't work — re-export choosing the splat format in your capture tool. |
| My file is too big to upload | Check your plan's limit (Free and Premium 1.5 GB, Business/Enterprise 5 GB). Export a compressed .spz/.sog instead of PLY, crop the capture in the SuperSplat editor, or upgrade. |
| Rejected for too many splats | Scenes can hold up to 5 million splats on Free and Premium and up to 20 million on Business/Enterprise. Reduce the capture in the SuperSplat editor (crop or delete unneeded areas) and export again, or upgrade. |
| Processing failed on my scene | Delete the failed scene and upload again. If it fails repeatedly, re-export the file from your capture tool — a fresh export fixes most damaged files. |
| I can't upload another splat scene | One of your splat scenes is still processing — each account runs one splat build at a time. Wait for its tile to turn ready (or failed) and try again. If a scene has been processing for more than a day, contact us and we'll unblock it. |
| The reference mesh doesn't line up with the splat | Turn it with the rotate buttons in the Collider mesh menu (90° steps about X, Y or Z, combinable) and watch the wireframe overlay — these are the common mismatches between tools. If it's still off, re-export the mesh from the same project as the splat, with the same coordinate setting. |
| My reference mesh is rejected | It must be a single .glb with embedded data, exported uncompressed (no Draco or mesh quantization), under 100 MB and 10 million triangles. Decimate the mesh, strip textures and disable compression in your 3D tool, then export again. |
| My scene takes a long time to open since I added the reference mesh | The reference mesh is downloaded before the scene shows. Decimate it to well under 1 million vertices (a few MB) and upload it again from the Collider mesh menu — measurement accuracy barely changes. |
| My scene is sideways or upside down | Open the editor and use the Orientation menu to rotate it upright. Do this before adding points of interest or GPS — orientation locks once they exist. |
| The capture looks noisy or has floating blobs | That's the capture itself, not the upload. Clean it in the free SuperSplat editor (delete floaters, crop the edges) and use Update source file to replace the scene's file. |
Ready to publish your capture?
Create a free account and turn your first Gaussian Splat into an interactive web scene in minutes — no credit card needed.
Start free Learn more about splat scenes