Skip to content

Importer FAQ

Frequently Asked Questions (FAQ)

Find answers for installation, dependencies, import behavior, variants, animation clips, and common Maya workflow questions.

Open Importer Overview Install the Plug-in View Supported Features

General Questions

What is the glTF Importer for Maya?

The glTF importer is the import side of the glTF Importer and Exporter for Maya package. It imports glTF and glb files into Autodesk Maya with materials, animation, variants, and related scene data.

The same package also provides glTF2.0 Export, the Animation Clips and Material Variants panels, and the Export Log. See glTF2.0 > About in Maya for a short product overview.

What versions of Maya are supported?

Windows / Linux / macOS: Maya 2022-2027.

Windows: KTX2 natives are bundled for Maya 2022-2027.

macOS note: Full functionality including KTX2 texture compression is verified for Maya 2026 only. Earlier Maya years on macOS auto-load, but KTX2 and other year-specific native features may be unavailable. Maya 2027 KTX2 natives are not yet built for macOS.

  • The plugin needs NumPy. The installer checks for it.
  • If it shows Not found, click Install NumPy (internet required).

See Plugin Installation.

Installation Questions

Why am I getting installation errors?

Common installation issues can be resolved by:

  1. Using Maya 2022-2027
  2. Unzipping the download before you drag INSTALL.py
  3. Installing NumPy if the installer says it is missing
  4. Running Maya as administrator only for an all-users install
  5. Following Plugin Installation
Do I need to install additional dependencies?

The plugin needs NumPy. If the installer shows Not found, click Install NumPy. You do not need administrator rights. You do need internet for the download.

Full steps: Plugin Installation.

What if this computer is not connected to the internet?

Downloading NumPy and opening Installation help both need internet. After NumPy is installed, you can import and export offline.

If Install NumPy fails, connect and try again, or ask your IT team to install NumPy for this Maya. See No internet.

Where should I install the plugin files?

Pick one location. For most people, keep the recommended choice: Maya package: This user only.

  • Windows: this user, or all users on this computer
  • macOS: this user, or all users on this Mac (KTX2 verified on Maya 2026)
  • Linux: Maya module, or Maya plug-ins and scripts

If your studio already uses Maya modules, choose Maya module. Full steps: Plugin Installation.

Import Questions

What file formats are supported?

The plug-in supports both:

  • .gltf files (JSON format with external assets)
  • .glb files (binary format with embedded assets)
Is Draco (KHR_draco_mesh_compression) supported?

Draco mesh compression decoding is supported on Windows and macOS (native extern_draco libraries ship with the package).

On Linux, Draco decode is not currently shipped. Files that use KHR_draco_mesh_compression may fail to import or import without geometry. Re-export the asset without Draco compression, or provide an uncompressed glTF/GLB, to import successfully.

What file type should I choose in Maya's Import dialog?

In Maya's native Import dialog, choose the file type glTF2.0 Import.

If you do not see it, follow Plugin Installation and confirm the package is installed correctly.

Why isn't my glTF/glb file importing correctly?

Several factors can affect import success:

  1. File compatibility: Check Asset Compatibility and Workarounds. Sketchfab auto-generated assets may require preprocessing.
  2. File format issues: Ensure your file follows the glTF 2.0 specification.
  3. Missing textures: Verify all referenced textures are available.
  4. Large file size: Very large files may require specific settings.
  5. Asset source: Assets from Khronos Sample Assets, Maya/Babylon exporter, or Blender's glTF 2.0 exporter typically work best.
  6. Scale issues: If imported assets appear too large, use Unit Scale in Geometry Options and select 1.0.
Can I import animations from glTF/glb files?

Yes. The plug-in supports skeletal animations, transform-based animations, and morph targets.

  • Configure options in Animation Settings before importing
  • Default animation FPS is 24 fps (Film)
  • Enable Open Time Editor Window to open Maya's Time Editor automatically after import
  • Use Animation Clips to manage multiple clips organized in Maya's Time Editor
How do I handle material variants?

Open Material Variants. Each imported glTF is its own File, and the list shows only that File’s variants. Use the eye icon to preview a look, and Assign Variant to record the current material on the selected meshes.

A second import adds another File. It does not append those variants onto the first File. Authoring from scratch, including Create File, Export Empty variants, and export order, is in Exporter Material Variants.

How do I open Material Variants or Animation Clips after import?

Open the glTF2.0 menu in Maya, then choose either Material Variants or Animation Clips.

  • Material Variants opens the Material Variants panel
  • Animation Clips opens the Animation Clips panel
  • The Animation Clips panel works with the clips organized in Maya's Time Editor
My imported asset from Sketchfab appears too large or has deformation issues

Sketchfab assets, especially auto-generated ones, may have scale or deformation issues. Try these solutions:

  1. Scale issues: Use Unit Scale in Geometry Options and select 1.0
  2. Deformation issues: Ensure Import Skin Binding is enabled. Inverse bind matrices are handled automatically during import.
  3. Import only static geometry: Disable Import Skin Binding, Import Blendshapes, and Import Animations together
  4. For more detailed workarounds, see Asset Compatibility and Workarounds

Material Questions

Why don't my materials look correct after import?

Material appearance can be affected by:

  1. Shader type selection: Choose the appropriate shader type in Material Settings - Standard Surface, Arnold, OpenPBR, or Stingray
  2. Shader limitations: Stingray only supports basic properties, and OpenPBR may have rendering limitations with Arnold
  3. Ambient Occlusion: Enable Import Ambient Occlusion in Material Settings to import AO from the ORM texture and multiply it with base color
  4. Texture paths: Ensure textures are properly linked
  5. Maya's material system: Some glTF material features may need manual adjustment
  6. Lighting setup: Your Maya scene lighting affects material appearance
Can I extract textures during import?

The importer handles textures differently depending on the file type:

  • GLB files: The importer extracts and saves textures using Image Extraction because textures are embedded in the binary file. By default, when Use Relative Path is unchecked, textures are saved to your Maya project's sourceimages directory. When Use Relative Path is enabled, textures are saved relative to the GLB file location.
  • GLTF files: Extraction is not needed because textures are external files. Texture image paths are set relative to the GLTF file location automatically.
How do I handle PBR materials?

The plug-in converts PBR materials to Maya-compatible materials. You can choose from multiple shader types:

  • Standard Surface: Best for general use with Arnold and other renderers
  • Arnold: Optimized for Arnold renderer workflows
  • OpenPBR: Industry-standard PBR shader, though Arnold may not render all properties correctly
  • Stingray: Legacy option, only supports basic material properties such as BaseColor, ORM, Normal, and Emissive

You can also enable Import Ambient Occlusion to import AO from the ORM texture and multiply it with base color for enhanced depth and shadow detail. Some manual adjustment may still be required depending on the chosen shader type.

Performance Questions

Why is my import taking so long?

Import time can be affected by:

  1. File size: Larger files take more time to process
  2. Geometry complexity: High-poly models require more processing
  3. Texture resolution: Large textures increase import time
  4. Complex rigged assets: Assets with complex rigging and skin binding may take longer due to the skin-binding process
  5. Computer specifications: Available RAM and CPU/GPU power
Can I optimize import performance?

Yes. There are several ways to optimize import performance depending on your needs:

For Static Geometry (No Animation Needed):

  • Disable Import Animations in Animation Settings to skip animation processing
  • Disable Import Skin Binding in Geometry Options to avoid processing skeleton and skinning data

For Geometry Optimization:

For Material Optimization:

  • Disable Import Materials in Material Settings if you only need geometry and plan to assign materials manually later

These optimizations are particularly effective for large files, complex rigged assets, or when you only need specific aspects of the imported content.

Troubleshooting

The plugin menu doesn't appear in Maya

If the glTF2.0 menu is not visible:

  1. Verify the plug-in is properly installed
  2. Check that the plug-in is loaded in Maya's Plugin Manager
  3. Restart Maya after installation
  4. Check Maya's Script Editor for error messages
I'm getting error messages during import

Common solutions:

  1. Check the Limitations and Known Issues page
  2. Verify your file meets the glTF 2.0 specification
  3. Try importing a simpler test file first, such as an asset from the Khronos Sample Assets repository
  4. Check Maya's Script Editor for detailed error information
  5. If importing Sketchfab assets, see Asset Compatibility and Workarounds for preprocessing steps
  6. For Sketchfab assets with issues, try disabling Import Skin Binding, Import Blendshapes, and Import Animations together to import only static geometry and materials
My animations aren't playing correctly

Animation issues can often be resolved by:

  1. Checking Animation Settings configuration and ensuring Import Animations and, when needed, Import Blendshape Animations are enabled
  2. Setting Maya's playback speed to Real-time in the Time Slider options so imported FPS is respected
  3. Enabling Open Time Editor Window in Animation Settings to open the Time Editor automatically after import
  4. Using Animation Clips to manage multiple animations organized in Maya's Time Editor
  5. If you are on Maya 2023 or earlier and blendshape animations do not play, use the automated Bake to Scene workflow in Animation Clips or the Time Editor's Bake menu as described in Asset Compatibility and Workarounds
  6. Verifying timeline settings in Maya
  7. Note that Sketchfab assets with rigged animations may require preprocessing. See Asset Compatibility and Workarounds.
Why do imported objects disappear when I enable shaded display with texture maps (press 6)?

If imported meshes or geometries disappear when you enable shaded display with texture maps by pressing 6, this can be caused by:

  1. Backface Culling: Change the Backface Culling setting to off in the mesh shape node under Mesh Component Display
  2. Opacity Connection: The shader's Opacity attribute may be connected, causing transparency issues. Temporarily disconnect it in the shader's Attribute Editor to verify.
  3. Viewport Renderer: Start Arnold in the viewport to see the render result, which may display the geometry correctly

To see advanced material properties such as sheen, iridescence, clearcoat, and transmission, start Arnold in the viewport renderer or render with Arnold.

Maya's default viewport renderer may not display all advanced material properties correctly, so Arnold is required to visualize these effects reliably.

Advanced Usage

Can I batch import multiple files?

The plug-in focuses on individual file import. For batch operations, you can use Maya's scripting capabilities with the programmatic interface.

See Technical Details for MEL and Python command examples.

How do I handle very large glTF scenes?

For large scenes:

  1. Consider splitting the scene into smaller files
  2. Use selective import options. Disable Import Skin Binding if you do not need animation, or disable Import Materials to import geometry only.
  3. Optimize geometry before import
  4. Monitor Maya's memory usage
  5. Use Merge Vertices to reduce geometry complexity
Can I re-export imported glTF/GLB files with the built-in exporter?

Yes. For the most reliable round trip:

  1. Keep Use file/place2dTexture texture nodes enabled during import so UV transforms and UV-set assignments are exporter-friendly
  2. Keep Import Materials enabled if you want to preserve imported shading networks and variants
  3. Export with Time Editor Clips and Bake Animation Keyframes On when you want to preserve imported clip organization. Clips from every imported file are included, not only the composition selected in Animation Clips
  4. If the scene contains gaussian splats, make sure the companion GaussianSplatPlugin is loaded for both import and export. It is Windows only. Get it from PolyPulse3D.

See Asset Compatibility and Workarounds and Exporter Round-Trip Workflow for details.

Why are my gaussian splats not importing?

Importing KHR_gaussian_splatting primitives requires the companion Gaussian Splat Importer and Exporter for Maya plug-in (GaussianSplatPlugin) to be installed and loaded. That companion plug-in is Windows only. When it is missing, splat primitives are skipped with a warning and the rest of the import continues.

Get the companion plug-in from https://polypulse3d.com (Windows only).

Where do I get the Gaussian Splat companion plug-in?

Download Gaussian Splat Importer and Exporter for Maya from https://polypulse3d.com. It is Windows only (macOS and Linux are not supported). After installing it for your Maya version, load GaussianSplatPlugin, then re-import or re-export with Gaussian Splats enabled.

What's the difference between 'No merging' and 'Merge Vertices'?
  • Merge Vertices: Combines vertices that share the same position while preserving UV seams
  • No merging: Preserves the imported split-vertex layout exactly as authored
Can I modify import settings after import?

Import settings apply during the import process. To change settings, re-import the file with the new configuration.

After import you can still:

Getting Help

Where can I find more technical information?

Detailed technical information is available in Technical Details, including programmatic import using MEL and Python commands with all available import options.

How do I report bugs or request features?

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 include:

  1. Maya version and operating system
  2. Asset source such as Sketchfab or a custom export
  3. File size and complexity details
  4. Specific error messages or unexpected behavior
  5. Sample files when possible and appropriate
  6. Output logs from the Maya Script Editor
  7. Steps to reproduce the issue
Are there example files I can use for testing?

The Khronos glTF Sample Assets repository provides official test assets that work well with the plug-in.

These are recommended for testing your installation and understanding the import process. Assets exported from Maya using Babylon exporter or from Blender using the built-in glTF 2.0 add-on also work reliably.

If your question isn't answered here, please check the other documentation pages, report an issue, or join the Discord server for additional support.