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 component of the glTF Importer and Exporter for Maya plug-in package. It allows you to import glTF (GL Transmission Format) and glb (Binary glTF) files directly into Autodesk Maya.

It enables seamless integration of 3D assets that follow the glTF standard into your Maya workflow.

What versions of Maya are supported?

The package supports Maya 2022 or later.

  • Maya 2024 and earlier: Install numpy separately
  • Maya 2025+: numpy is included by default

See Plugin Installation for the full requirements.

Installation Questions

Why am I getting installation errors?

Common installation issues can be resolved by:

  1. Ensuring you have the correct Maya version
  2. Verifying all dependencies are properly installed
  3. Checking that you have sufficient permissions to install the package
  4. Following the step-by-step instructions in Plugin Installation
Do I need to install additional dependencies?
  • Maya 2024 and earlier: Yes, you need to install numpy
  • Maya 2025+: No additional dependencies are required because numpy is included by default

Follow Plugin Installation for the step-by-step dependency instructions.

Where should I install the plugin files?

Copy the entire gltf_importer_exporter_for_maya package folder into one of the Windows Autodesk ApplicationPlugins locations:

  • C:\ProgramData\Autodesk\ApplicationPlugins\gltf_importer_exporter_for_maya for a machine-wide install
  • %APPDATA%\Autodesk\ApplicationPlugins\gltf_importer_exporter_for_maya for a per-user install

That folder must contain PackageContents.xml and a Contents folder.

Refer to Plugin Installation for the tested Windows installation flow.

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 only.

On macOS/Linux, 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?

Material variants are supported through Material Variants.

This lets you switch between different material configurations defined in your glTF file.

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 when you want to preserve imported clip organization, or use Baked when you need a flatter result for downstream tools
  4. If the scene contains gaussian splats, make sure the external gaussianSplat plug-in is loaded for both import and export

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

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?

You can report bugs, request features, share suggestions, view announcements, and get support by joining the Discord server.

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 or join the Discord server for additional support.