Skip to main content

Direct Upload

If you already have a clean splat file, you don't need to use the SuperSplat Editor to publish it. The Direct Upload flow lets you push a finished splat straight to your Manage page, where you can open it in Studio or share its scene page.

This is the right path when:

  • Your splat is already clean (no floaters, no unwanted background, sized appropriately).
  • You produced the splat in another tool — a training pipeline, a smartphone scanner, or via the Convert utility or the splat-transform CLI.
  • You want to publish quickly without round-tripping through the Editor.

The Upload Splat dialog — a Publish-to selector and a click-or-drag file drop area

Launching the Upload dialog​

There are three ways to open the Upload Splat dialog:

  • The orange Upload Splat button on the superspl.at home page. The fastest path if you're not already logged in or in the manage view — you'll be prompted to sign in.
  • The Upload Splat button on the Manage page.
  • Navigating to superspl.at/upload, which redirects to the Manage page with the dialog open.

You must be signed in with a PlayCanvas account to upload. See Account Creation.

Supported input formats​

Drag and drop, or pick from your filesystem. The dialog accepts these formats, each up to its own maximum size. Its Upload Guide summarizes them. Below the drop area, the dialog also shows how much of today's publishing allowance you've used and when it resets.

FormatFile to uploadMaximum sizeHow it is validated
PLY.ply15 GBA PLY file containing Gaussian splat data. A PLY that holds only a mesh or a point cloud is rejected.
SPZ.spz5 GBA readable SPZ file.
SOG.sog10 GBContains one meta.json file and the expected SOG WebP payload files.
Streamed SOG bundle (SSOG).zip10 GBContains lod-meta.json and one or more SOG chunk folders. See Streaming & Performance.
LCC or LCC2.zip10 GBContains exactly one .lcc2 file, or exactly one .lcc file with sibling index.bin and data.bin files.

The file contents are validated after selection. Direct Upload does not accept .compressed.ply, .ksplat, or .splat files directly. Use the Convert utility or the splat-transform CLI to convert those first, or to bring a file under its format's maximum size.

Levels of detail​

When you choose a PLY or SPZ file, the dialog shows an Auto generate LODs checkbox. When it is ticked, the splat is published as a progressively streamed Streamed SOG instead of a single SOG file. It is ticked automatically for splats of 1 million Gaussians or more, and you can change it before uploading. Splats of more than 40 million Gaussians must be streamed, so for them it is ticked and locked. SOG files are always published as a single file, while SSOG and LCC archives are always streamed.

What happens after upload​

The dialog moves through four stages:

  1. Select — choose a file (or drop one in).
  2. Ready — the file is validated locally. You can change it before continuing.
  3. Uploading — the file streams to PlayCanvas storage.
  4. Publishing — the platform creates the scene record.

When publishing completes, the dialog switches to the Edit Splat view for the newly created scene so you can immediately fill in metadata. The defaults are deliberately conservative:

FieldDefault
TitleYour filename with the extension removed
Description(empty)
VisibilityUnlisted — your splat is reachable only via its direct URL
DownloadableOff — visitors can view but not download the source file

From the Edit Splat view, you can:

  • Adjust Title and Description.
  • Tag the Software Used to capture or train the splat (visible as chips on the scene page).
  • Flip Visibility to Public to make the splat appear in Explore searches.
  • Enable Downloadable and pick a Creative Commons license.
  • View the public scene page, or Open in Studio to curate the viewing experience.

Errors​

ErrorCause
Unrecognized FormatThe file does not match one of the supported structures above.
No Gaussian Splat DataThe file is a valid PLY, but it holds a mesh or a point cloud rather than a Gaussian splat.
File Too LargeThe file is larger than its format's maximum size. The message gives both sizes.
Upload FailedNetwork interruption or a server-side issue. Try again; if the problem persists, check your connection.

Your account's publishing limits also apply. When you reach one, the dialog says so (Publishing Allowance Used or Scenes Still Processing) and when you can upload again.

See also​

  • Publishing from the Editor — the alternative path that goes through the SuperSplat Editor
  • Manage — what to do with your splat once it's uploaded
  • Studio — curate the viewing experience for a published splat