Before you start
Roblox Studio imports glTF files, both the text .gltf and the binary .glb, through its Importer. Three things decide whether a GLB comes in cleanly:
- Units. glTF always stores distances in metres. Studio measures in studs, and one stud is 28 cm, so you have to tell the Importer the file is in metres. More in Roblox studs to metres.
- Triangles. Each mesh can have at most 20,000 triangles (as of November 2026). The limit is per mesh, not per model. More in Roblox mesh limits explained.
- Mesh count. Studio makes a separate MeshPart for every mesh in the file, so a model built from 150 pieces arrives as at least 150 parts.
If you don’t know what’s inside your file, open it in Blender first (how to open a GLB in Blender) or read what a GLB file is.
Step by step: import a GLB with the Importer
- Open the Importer. Click Import on the Studio ribbon, choose File › Import, or press Ctrl+M (Cmd+M on a Mac). Since April 2026 the same window also imports images, audio and video, so older tutorials call it the 3D Importer or “Import 3D”.
- Pick the .glb. With one file selected, the import preview opens: a 3D preview, the object hierarchy on the left and the settings on the right.
- File General. Name the asset. Turn Upload to Roblox off while you’re testing, so each attempt doesn’t add another copy to your Toolbox and Asset Manager, and back on for the final import. Leave Add to Workspace on: it inserts the model and, in a saved or published place, gives that place permission to use the asset. Turn Anchored on for anything that should stay put.
- File Transform. Leave World Forward on Front and World Up on Top. glTF is Y-up, which suits these defaults. Change them only if the preview shows the model on its side or facing the wrong way.
- File Geometry. Set Scale Unit to Meter. The default, Studs, reads every metre in the file as one stud, so a 2 m door comes in 56 cm tall. This section also shows the file’s dimensions and triangle count: check both. The custom scale factor below it multiplies the result; leave it at 1.0 unless you want the model bigger or smaller on purpose.
- Read the warnings. Studio puts a warning or error icon in the hierarchy or the settings panel when it finds a problem. Expand the hierarchy down to the flagged object to read the message.
- Click Import. Afterwards, right-click the asset in the Importer and choose Find in Workspace to jump to it, or Copy asset ID to reuse it.
The settings that matter
| Setting | Section | Default | For a static prop |
|---|---|---|---|
| Scale Unit | File Geometry | Studs | Meter |
| Custom scale factor | File Geometry | 1.0 | 1.0, or more to make it larger than life |
| Merge Meshes | File Geometry | Off | On for a many-part prop, if it fits in 20,000 triangles |
| Invert Negative Faces | File Geometry | Off | On only if parts look inside out |
| Anchored | File General | Off | On (not applied to rigged meshes) |
| Upload to Roblox | File General | On | Off while testing, on for the final import |
| Add to Workspace | File General | On | On |
| Set Pivot to Scene Origin | File General | On | On: the pivot lands at the file’s origin |
| Insert Using Scene Position | File General | Off | Off; on for scene pieces that must keep their positions |
| World Forward / World Up | File Transform | Front / Top | Leave as they are |
| Rig Type | Rig General | Detected | Only shown for rigged files; a prop rig is Custom, not R15 |
| Make Double Sided | Object Geometry | Off | On only for thin, card-like parts (it costs performance) |
Why a GLB turns into dozens of MeshParts
Roblox documents the glTF import hierarchy: the import is a Model, and inside it every glTF mesh becomes its own Model holding one MeshPart per primitive. Most exporters write one primitive per material, so you get at least one MeshPart for every separate piece in the file.
Props built from many pieces feel this most. The fire truck in the public prop library is 456 separate meshes with 18,954 triangles in total, so its plain GLB comes in as at least 456 MeshParts. That isn’t wrong, but every part is a separate physics part with its own collision shape, and the pile is slow to select, anchor and move. If you leave Anchored off, play-test to make sure the pieces don’t separate.
Merge Meshes fixes the count: it turns all the MeshParts into one MeshPart instead of a Model. Two catches. A single mesh still has to fit in 20,000 triangles. And Roblox’s texture specifications say a mesh object can only have one material, so colours that lived on separate materials need to be in a texture or in vertex colours to come through a merge.
Collisions: pick a CollisionFidelity for each prop
Every MeshPart has a CollisionFidelity property that sets how closely its physical shape follows what you see. Roblox lists the first four from cheapest to most expensive; Tunable sits alongside them:
| Option | Collision shape | Good for |
|---|---|---|
| Box | The bounding box | Small props and decor: crates, cones, mugs. Lowest memory. |
| Hull | A convex hull, like shrink-wrap with no dents | Rounded solid props: barrels, boulders, bins |
| Default | An approximate shape that supports concavity | Props with gaps that matter a little: chairs, fences |
| PreciseConvexDecomposition | The closest fit, still not exact | Large props players move through, such as arches. Use sparingly. |
| Tunable | Adds a CollisionPrecision slider | When Default is too rough and Precise too costly |
Roblox’s performance guide recommends Box for small anchored parts, Box or Hull for small and medium props, and invisible parts as custom collision for large, complex ones. For props nobody touches, set CanCollide, CanTouch and CanQuery to false and still pick Box, because the collision geometry stays in memory. To see what you picked, turn on Collision fidelity in the Visualization Options at the top right of the viewport.
A merged prop is one collision shape. A merged wooden table on Box or Hull is a solid block, which is fine if players walk around it. If they need to crawl underneath, try Default or Precise. And bones don’t move collisions: an animated door still collides where it stood closed.
Errors and warnings, and what to do about them
| What you see | Likely cause | Fix |
|---|---|---|
| An error on a mesh, or the import refused | A mesh over 20,000 triangles | Split it into meshes under 20,000 each, or reduce it (Blender’s Decimate modifier) |
| The model is tiny | Scale Unit left on Studs | Re-import with Meter |
| The model is 5.6 times too big | A preset with scale factor 5.6, set to keep the pre-June 2026 size | Set the factor back to 1.0 |
| On its side or facing away | Axis settings | Change World Up or World Forward, or rotate after import |
| Missing texture error | A .gltf whose image files aren’t next to it | Use a .glb with textures embedded |
| Faces look inside out or see-through | Mirrored parts, or thin one-sided cards | Invert Negative Faces, or Make Double Sided for the cards |
| Hundreds of parts in the Explorer | One MeshPart per primitive | Merge Meshes, or a file that’s already merged |
| The asset doesn’t load in your place | Add to Workspace was off, so the place has no permission | Import again with Add to Workspace on |
You’ll still find DevForum threads quoting 10,000 or 21,000 triangles. Those are old or unofficial figures; Roblox’s mesh specifications say 20,000.
How Propsmith’s Roblox download avoids these problems
Propsmith, an AI 3D prop generator, writes each model as code from simple shapes, so a model is many named parts. That’s good for editing and animation and awkward for a Roblox import, so every model page has a separate Roblox download next to GLB and STL. It’s still a GLB (the file name ends in .roblox.glb), prepared for the Importer:
- One mesh instead of hundreds. All the parts are merged into one mesh. Models over 19,000 triangles are split into chunks that each stay below the 20,000 limit. The fire truck arrives as one MeshPart; the oak tree (36,172 triangles) as two.
- One material. Colours, roughness and metalness are packed into a tiny palette texture (16 × 16 pixels for most library props), so the merged mesh keeps its colours.
- Real-world size. Models are built in metres, standing on the ground at the origin. With Scale Unit on Meter they come in at their real size, with the pivot near the bottom centre.
- Animation Roblox can read. Roblox only imports animation that drives the bones of a skinned mesh, so the animated Roblox download has a bone for each moving part with the animation baked onto it. See how to import an animated model into Roblox Studio.
The trade-off: the static Roblox file is one mesh, so you can’t select or recolour a lid on its own in Studio. If you need separate parts, take the plain GLB and accept more MeshParts, or make the change in Propsmith first (an edit costs 5 credits). A mesh file also can’t carry scripts, which is one reason mesh-only props are a safe source of free models.
Fire truck18,954 triangles
Oak tree36,172 triangles
Wooden crate4,052 triangles
Wooden table3,260 triangles
Traffic cone2,028 triangles
Street lamp13,448 triangles
More to try: props picked for Roblox games, street and city props, furniture, or the whole public prop library.