Skip to content

Exporter Reference

Limitations and Known Issues

Current limits to keep in mind when authoring scenes and choosing export options.

Open Exporter Overview Install the Plug-in View Supported Features

General

  • Some optional features only appear in the file when the scene already has the matching data.
  • On Windows, KTX2 natives ship for Maya 2022-2027. On macOS, the plug-in auto-loads on Maya 2022+, but full functionality including KTX2 is verified for Maya 2026 only (Maya 2027 KTX2 natives are not yet built for macOS).

Textures and compression

  • KTX2 and Draco need the matching tools/runtimes available in your install.
  • Texture conversion can make large scenes take longer to export.
  • Leave Compress Normal Maps off unless you have checked the look - lossy compression can hurt normals more than color maps.
  • UV rotation from aiImage nodes is not exported.
  • UV rotation from place2dTexture is written with compensation for Maya’s UV center, but some viewers still do not play rotation back correctly. Offset, tiling, and wrap modes are reliable.

Round trip

  • Quad topology round trip needs the Maya-specific metadata in the file.
  • Material variants round-trip when the variant data and alternate materials stay in the scene. Each imported glTF keeps its own File.
  • Texture placement round trip works best when you imported with Maya file and place2dTexture nodes.
  • For StingrayPBS, metallic and roughness share one packed texture. If AO uses different UVs, it may be written as a separate occlusion map instead.

Gaussian splats

  • Needs the companion Gaussian Splat Importer and Exporter for Maya plug-in (GaussianSplatPlugin). It is Windows only. Get it from PolyPulse3D. If it is missing, splat shapes are skipped and the rest of the export continues.
  • Export SH Degree (default 3) can drop higher lighting bands for smaller files; it does not change the Attribute Editor preview slider on the companion plug-in.

Animation

  • Always check multi-clip products in your target viewer (for example Babylon), not only in Maya.
  • Visibility show/hide may look different across viewers.
  • Bake off keeps more Maya curve detail for re-import; Bake on or Sampled is safer for web delivery and full spins.
  • Long clips that only have plain timeline keys (no Time Editor clips) can take longer to export.
  • Hold / still clips need their pose and visibility kept in the file so selecting that clip in a viewer shows the intended product state.

Reporting Issues

If you encounter limitations not listed here, use glTF2.0 > Report an Issue in Maya, or open the contact page. You can also join the Discord server for announcements and community support.

When reporting issues, please provide Maya version and operating system, the export options you used, Script Editor or Export Log output, and steps to reproduce the issue. Sample files help when they can be shared.