Troubleshooting
The Editor Does Not Start
The Editor requires WebGPU. If the page shows "SuperSplat requires WebGPU, which this browser does not support" instead of loading, switch to a supported browser and make sure hardware acceleration is turned on in the browser's settings. On a machine with more than one GPU, the browser must be allowed to use the dedicated one.
If the message is "SuperSplat failed to start", open the browser console for details and include them when you report the problem.
A File Does Not Import
- Confirm that the file uses a format listed in Import and Export. A generic or "vanilla" PLY containing only mesh or point-cloud data will not load. SuperSplat requires a 3DGS PLY with Gaussian attributes such as position (
x,y,z), scale (scale_*), rotation (rot_*), opacity, and spherical harmonic color (f_dc_*, with optionalf_rest_*). See How 3DGS PLYs Differ from Regular PLYs. - For formats made of several related files, drag the parent folder into the Editor so relative file paths remain available.
- When importing from a URL, the remote server must allow the browser to fetch the file using Cross-Origin Resource Sharing (CORS).
- If the browser reports insufficient memory, try a lower-detail source file, close other GPU-heavy tabs, and import splats separately.
- If the browser refuses to read a file you picked, SuperSplat shows File Access Blocked. Click OK and choose the same file again in the browser's file dialog to continue. Other read failures show an Error Loading File message with the browser's reason.
- When you import several files at once, files SuperSplat does not recognize are listed as Not supported in the Import Files dialog and skipped; the rest import normally. See Importing Several Files.
- A splat loaded from a URL that has no file extension, such as a signed download link, needs a
filenameparameter to identify its format. See the URL loading instructions in Import and Export.
Selection Does Not Match the Visible Surface
Check the mode strip beside the View Cube:
- X-Ray (N) is on by default, so a selection reaches through the whole scene and also picks Gaussians hidden behind the surface you clicked. Turn it off to select only the visible surface. With X-Ray off and Markers on, markers are drawn only on the Gaussians a selection can reach, which shows you what a drag would pick.
- In Centers mode (the default, M toggles), a Gaussian is only picked when its center lies inside the tool's shape. Large, soft Gaussians whose centers sit just outside your selection are left out; switch to Rings mode to select by the whole footprint instead.
Pressing Tab only shows or hides the markers; it does not change how selection works. Locked or deleted Gaussians cannot be selected; use Select > Unlock All or Select > Reset Splat when appropriate.
See Selection Mode and X-Ray and the cleanup recipes in Selection and Cleanup.
A Transform Moves the Wrong Content
If any Gaussians are selected, Move, Rotate, Scale, and numeric Transform values affect only that selection. Choose Select > None to transform the whole active splat.
If rotation or scaling moves content around an unexpected point, switch the origin control or double-click a visible surface to place the pivot. See Transform, Measure and Align.
Content Is Missing from an Export
Splat exports include visible splats. In the Scene Manager, enable the eye icon for every splat that should be included. Disable Solo mode and verify the complete result before exporting.
To combine splats into one PLY, use File > Export > PLY. File > Save creates an editable .ssproj project instead.
An Export Fails
SOG and Viewer App exports compress the splat on the GPU. On slower graphics hardware with large scenes, the GPU can stop responding during compression; SuperSplat then reports that the GPU stopped responding. Export again: each attempt starts on a fresh GPU device. If it keeps failing, close other GPU-heavy tabs or reduce the Gaussian count first.
Color Looks Different
- Check Preferences for the tone mapping curve, the number of spherical harmonic bands shown in the viewport, and the background color. These are view settings and are not written into exports.
- If small or distant Gaussians look too bright, the splat may have been trained with anti-aliasing (for example with Mip-Splatting) without a tag saying so. Set Anti-Aliasing in Preferences to On. If a file is tagged as anti-aliased when it was not, small Gaussians look too faint; choose Off. The setting is saved with the project.
- Expand Colors in the Scene Manager and click Reset to rule out a color grade applied to the splat or to a selection.
- Inspect the scene from several angles because spherical harmonic color is view-dependent.
See Color and Appearance for the difference between splat adjustments and viewport settings.
The Editor Is Slow or Runs Out of Memory
Large splats are limited by available GPU memory. Close other graphics-intensive tabs, work on one visible splat at a time with Solo mode, and choose a lower level of detail when importing a multi-LOD file. You can also reduce the Gaussian count by cleaning the splat. For large sequence imports, remember that every frame contains a full splat.
If the viewport stutters while you orbit a heavy scene, open Preferences and check Stochastic Alpha and Min Splat Size. Raising Min Splat Size hides more of the Gaussians that cover only a pixel or two on screen; lower it if small Gaussians leave gaps. For Stochastic Alpha, Auto (the default) switches to fast stochastic rendering during movement only once a sorted frame proves slow; choose Movement to use it during every camera move, or Enabled to use it all the time. The Frame Timings and Overdraw diagnostics in the Overlays popup show where the time goes: high GPU times together with a red-to-white overdraw map mean many overlapping Gaussians, which cleanup or a lower level of detail will reduce.
Unsaved Work or Project Confusion
Use File > Save or Save As regularly to preserve an editable .ssproj project. Exported PLY and other delivery formats are not substitutes for the project file when you need to continue editing splat layout, camera settings, or animation.
See Managing Projects for the difference between saving, opening, importing, and exporting.
Publishing or Rendering Fails
- Publishing requires you to be signed in to superspl.at with a PlayCanvas account.
- If
Publishis disabled with a message in the Publish dialog, your account has reached one of its publishing limits. The message says when you can publish again. - Scenes with more than 40 million Gaussians can only be published with Generate LODs on. Delete unwanted Gaussians first if you want to publish a single, non-streamed file.
- Video codec support depends on the browser. The Render Video dialog disables resolutions your browser or device cannot encode with the current settings — try a lower resolution, frame rate, or bitrate, another format or codec, or update your browser or graphics driver.
- A blocked download, private-browsing restriction, or low free memory can prevent large renders and exports from completing. In browsers without the File System Access API, renders and exports are delivered as downloads.
Reporting a Problem
If the problem persists, open Help > Log an Issue in the Editor and include the Editor version, browser version, operating system, GPU, source format, approximate Gaussian count, and the steps that reproduce the problem. The About dialog (Help > About SuperSplat, or click the version label in the bottom-right corner of the viewport) shows the Editor version and your GPU. You can also ask in the SuperSplat Discord community.