Glossi Docs
Getting Started

Common Issues and Fixes

If you're experiencing an issue with Glossi, find the relevant section below for step-by-step troubleshooting.

Model Upload Issues

Your 3D model can't be uploaded because Glossi doesn't recognize the file format.

Fix:

  • Ensure your model is saved in a supported format with geometry data included. USDZ, glTF/GLB, and FBX provide the best results.
  • If your file is in a different format, convert it using 3D software like Blender, Fusion 360, or Rhino before uploading.

Your model file exceeds the maximum upload size.

Fix:

  • Optimize your model's geometry by reducing polygon count where detail isn't critical, and compress textures without significantly affecting quality.
  • Consider splitting complex models into separate components if your project allows.
  • For guidance, see our optimization guide.

Your upload begins but fails to complete or times out during processing.

Fix:

  • Ensure you have a stable internet connection during the entire upload process.
  • Check that your model doesn't contain corrupt geometry or invalid materials. See our preparing your 3D models guide for best practices.
  • Try uploading a smaller test file to isolate whether the problem is file-specific.

Studio Connection Problems

You see "Launching Studio" for an extended period without successfully connecting.

Fix:

  • Allow at least 3 minutes for the initial connection before troubleshooting.
  • Check that your internet connection meets the minimum requirements (15 Mbps download, 5 Mbps upload) and that your browser supports WebRTC.
  • Try logging out and logging back in to reset your connection.
  • Clear your browser cache and cookies.

For more details, see Connecting to Studio.

The studio interface is laggy or unresponsive.

Fix:

  • Check your internet connection speed and stability.
  • Close other bandwidth-intensive applications and browser tabs.
  • Reduce the number of lights and complex materials in your scene.
  • Try using a different supported browser (Chrome, Firefox, Safari, or Edge).

You're repeatedly disconnected from Studio during your session.

Fix:

  • Disable VPNs or proxy servers that might interfere with the WebRTC connection.
  • Check if your network has firewall restrictions that could block sustained WebRTC connections.
  • After three disconnections, try logging out completely and starting a new session.

Material and Display Issues

Your model's materials or textures aren't appearing as expected in Studio.

Fix:

  • Ensure you're using a file format that includes texture and material data. USDZ and GLB are recommended for the most reliable material transfer.
  • Verify that material slots are properly assigned in your 3D software before exporting, and that all texture files are included with your model during export.
  • Use Glossi's built-in material editing tools to adjust materials after upload.

Textures are missing, appear grayscale, or display incorrect colors.

Fix:

  • Confirm your export format supports embedded textures — USDZ and GLB are recommended.
  • Check UV mapping in your 3D software to ensure textures are correctly applied.
  • Verify that texture paths are relative rather than absolute in your source file.
  • If using procedural textures, bake them to image textures before export.

Your model appears pixelated, blurry, or with visual artifacts.

Fix:

  • Check your internet connection quality, as stream resolution adapts to available bandwidth.
  • Ensure UVs and geometry are properly exported from your 3D tool.
  • A wired connection provides the most stable streaming quality.

Rendering and Export Issues

Rendering your project takes longer than expected.

Fix:

  • Complex models with detailed textures and materials naturally take longer to render. Advanced lighting setups with multiple light sources and reflective surfaces also increase render times.
  • Adjust export settings to balance quality and speed — reduce resolution or sample rates for faster results.
  • Use standard quality settings instead of maximum custom settings for draft renders.

Your export process fails to complete or produces corrupted files.

Fix:

  • Ensure you maintain a stable internet connection throughout the export process.
  • For large exports, avoid navigating away from Glossi during the process.
  • If exporting multiple files, try smaller batches if a large batch fails.
  • Clear your browser cache and try the export again.

Your exported renders show unexpected artifacts, noise, or quality problems.

Fix:

  • Increase anti-aliasing settings to reduce jagged edges.
  • Adjust sample counts for cleaner shadows and reflections.
  • For maximum quality, use the highest quality export preset.

General Troubleshooting

Glossi becomes unresponsive or crashes during use.

Fix:

  • Refresh your browser to reset the application state.
  • Clear your browser cache to eliminate potential conflicts.
  • Disable browser extensions that might interfere with WebRTC or streaming.
  • Try accessing Glossi from a different supported browser.

You experience ongoing interface issues or connection failures.

Fix:

  • Clear your browser's cache completely, including cookies and site data.
  • Try using an incognito or private browsing window to rule out extension conflicts.
  • Restart your router to reset your local network connection.
  • Try connecting from a different network to isolate whether the issue is network-specific.

Still Need Help?

If you've tried the relevant solutions above and are still experiencing issues, reach out to our support team. When contacting us, it's helpful to include:

  • Your browser type and version
  • A description of the issue and when it occurs
  • Steps you've already tried
  • Any error messages you've seen

On this page