PROPSMITH

How to import a GLB into Unity with glTFast

Published

In short

Unity needs a package to read .glb files, and Unity’s own is glTFast. In the Package Manager choose Install package by name, enter com.unity.cloud.gltfast (version 6.20.0 as of November 2026), then drag the .glb into your Assets folder and from there into a scene. glTF and Unity both work in metres, so the size is already right; add colliders yourself and save the result as a prefab.

Before you start

This guide uses Unity 6.3 LTS, the current long-term support release (supported until December 2027), and works the same on Unity 6.6, the newest release as of November 2026. You need Unity glTFast, Unity’s own glTF package. Version 6.20.0 came out on 25 August 2026 and needs Unity 6.0 or newer.

No scale conversion is needed. glTF stores distances in metres, and Unity’s own manual says its physics system expects 1 unit to be 1 metre. If GLB is new to you, read what a GLB file is.

The examples use models from the public prop library made with Propsmith, an AI 3D prop generator. Its GLBs have separate named meshes for each part, flat-colour materials with roughness and metalness (no image textures), and real sizes in metres. The office desk is 2,952 triangles over 48 meshes, so it arrives as a parent object with 48 children.

Free to download as GLB with a Propsmith account. Four low-poly props under 3,000 triangles, plus a bench and a 5 m street lamp to check scale.

Step 1: install glTFast

  1. Open Window › Package Management › Package Manager.
  2. Click the + (install) button in the toolbar and choose Install package by name. Newer editors label it Install package by technical name….
  3. Enter com.unity.cloud.gltfast as the name. Leave the version empty to get the latest compatible release, or type 6.20.0 to pin it.
  4. Click Install. Burst, Collections and Mathematics come with it as dependencies.

Step 2: import the GLB

  1. Drag the .glb into the Project window (or copy it into the Assets folder on disk). glTFast turns it into a prefab-like asset. Expand it to see its Scenes, Meshes, Materials and AnimationClips.
  2. Select it to see its import settings in the Inspector: Animation (None, Legacy or Mecanim), Generate Lightmap UVs, and advanced options for node names, textures and which components to create. Any warnings from the import show here too. Click Apply after a change.
  3. Drag the asset into the Scene view or Hierarchy. Each part becomes a child GameObject with a MeshFilter and MeshRenderer, named as in the file.

Materials in URP, HDRP and Built-in

glTFast supports all three render pipelines. It makes materials with its own shaders: Shader Graphs for URP and HDRP, and shaders for the Built-in pipeline, chosen by the pipeline active when the file is imported. If you switch pipelines later, right-click the .glb and choose Reimport so the materials are rebuilt. Flat-colour models need nothing else: base colour, metallic and roughness come straight from the file.

Imported materials are read-only parts of the .glb. To change one, select it inside the asset, press Ctrl+D (Cmd+D on a Mac) to make an editable copy, and assign the copy in the MeshRenderer of your prefab. You can also drop in your own URP Lit material.

All of this applies to editor import. If you load GLBs at runtime instead, the glTFast shaders have to be in the build: missing ones render solid magenta. The glTFast Project Setup page explains how to include them.

Step 3: add colliders

glTFast doesn’t create colliders. Add them to your scene instance (later saved as a prefab):

ColliderHowUse it for
Box Collider on the rootOn a root with no mesh of its own the box starts at 1 × 1 × 1. Set Size from the model page and adjust CenterCrates, desks, boxes: the fastest and most stable
Several primitivesChild objects with Box, Sphere or Capsule CollidersChairs, benches, lamps: a rough outline in a few shapes
Mesh Collider, Convex onOn a part’s GameObject; Unity builds one hull of up to 255 trianglesMoving props with irregular outlines
Mesh Collider, Convex offOn a part’s GameObject; uses the full meshStatic floors and stairs. Concave colliders can only be static or kinematic

Every library model page lists the real size in metres, width × height × depth, which maps straight onto a Box Collider’s X, Y and Z. The cardboard box is 0.4 × 0.3 × 0.3. Click Edit Collider to drag the box faces until the green outline meets the mesh. For a prop that falls and gets pushed, add a Rigidbody to the root as well.

Step 4: save it as a prefab

Drag the finished object from the Hierarchy into a folder in the Project window. Unity asks what to create:

  • Prefab Variant keeps the link to the .glb. Your colliders and material swaps are stored as overrides, and a reimported model still flows through. Pick this for models you might update.
  • Original Prefab makes a standalone prefab with no link back to the file.

Place the prefab, not the .glb, from then on. For props that never move, tick Static on the prefab so Unity can batch their many small meshes.

Step 5: animation, Mecanim or Legacy

Propsmith’s animated downloads carry one clip, named loop or once, that moves whole parts rather than bones. Library models list a suggested animation (the desk’s top drawer sliding open, for example) that you can build for 3 credits; the animated GLB appears once it exists.

For files dragged into the editor, glTFast sets the Animation setting to Mecanim and marks every clip Loop Time. It adds an Animator to the root but no controller. glTFast’s docs put it plainly: the clips “won’t be assigned and cannot be played back without further work”. You have two ways forward.

Mecanim (Animator)

  1. Choose Assets › Create › Animation › Animator Controller.
  2. Open it in the Animator window and drag the clip from inside the .glb onto the graph.
  3. Assign the controller to the Animator on your prefab’s root.
  4. For a once clip, select it inside the .glb, press Ctrl+D to copy it, untick Loop Time on the copy, and use the copy in the controller.

Legacy (Animation component)

Set Animation to Legacy and click Apply. The root gets an Animation component with the clip assigned and Play Automatically on, so it plays once when the scene starts. For a looping clip, set its wrap mode in a script: GetComponent<Animation>()["loop"].wrapMode = WrapMode.Loop;. For a prop with one clip, Legacy is less setup.

Troubleshooting

  • Magenta materials. The shader is missing: reimport after a pipeline change, or for runtime loading add the glTFast shaders to the build.
  • Wrong size. Check the root’s Transform scale is 1. Compare with the size on the model page; the street lamp should stand 5.01 units tall.
  • Convex collider looks rough. Convex Mesh Colliders are capped at 255 triangles. Use a few primitives instead.
  • Too many objects. Mark static props Static, or join the parts in Blender before import (see how to edit a GLB in Blender).

More test props: the furniture and street and city props hubs, or the modern genre. The same GLBs work in Godot 4, Unreal Engine 5 and, with the Roblox download, Roblox Studio.

Questions people ask

Can Unity open GLB files without a plugin?

Not on its own. Install Unity glTFast (com.unity.cloud.gltfast) from the Package Manager and Unity imports .glb and .gltf files dropped into the Assets folder like any other model.

What is the glTFast package name?

com.unity.cloud.gltfast. Version 6.20.0 (August 2026) is current as of November 2026 and needs Unity 6.0 or newer. Older tutorials use com.atteneder.gltfast, the package’s name before Unity took it over.

Does glTFast work with URP and HDRP?

Yes. It supports the Universal, High Definition and Built-in render pipelines and builds materials for whichever one your project uses at import time.

Why doesn’t my GLB animation play in Unity?

glTFast imports clips for Mecanim by default but doesn’t connect them, so the Animator has no controller. Create an Animator Controller and add the clip, or switch the importer’s Animation setting to Legacy.

Do I need to change the scale of a GLB in Unity?

No. glTF stores metres and Unity treats 1 unit as 1 metre, so a 0.8 m crate imports 0.8 units wide. glTFast doesn’t rescale it.

Sources

Checked 1 November 2026.