Skip to main content

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 current version of Chrome or Edge, Safari 26 or later, or Firefox with WebGPU enabled, 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 optional f_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.

Selection Does Not Match the Visible Surface​

Check the two toggles at the left of the bottom toolbar:

  • Selection Depth (N) is off by default, so a selection reaches through the whole scene and also picks Gaussians hidden behind the surface you clicked. Turn it on to select only the visible surface.
  • Selection Footprint (M) is off by default, so 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; turn it on to select by the whole footprint instead.

Pressing Tab only shows or hides the center and ring overlays; it does not change how selection works. Locked or deleted Gaussians cannot be selected; use Select > Unlock or Select > Reset when appropriate.

See Selection Depth and Footprint 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.

Color Looks Different​

  • Check Preferences for the tone mapping curve and the number of spherical harmonic bands shown in the viewport, and Appearance for the background color. These are view settings and are not written into exports.
  • 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. 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.
  • 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 browser version, operating system, source format, approximate Gaussian count, and the steps that reproduce the problem. You can also ask in the SuperSplat Discord community.