Skip to main content
Guide

How to Use GLB Viewer Online

GLB is the one format that arrives complete in a single file. This guide covers opening one, what the Info panel will and will not tell you about it, and how to frame and capture it without a second asset.

Published 6 min read

Why GLB is the easy format to open

Most 3D formats are a folder pretending to be a file. A .gltf is JSON that points at a .bin buffer and a directory of images; an .obj is geometry that points at an .mtl which points at more files. Moving any of those apart from their references is how you end up with a model that renders grey.

GLB has no such indirection. The JSON scene description and the binary buffer live in the same container, and textures are embedded inside it. That is why opening a GLB is a single action and why the GLB Viewer has nothing to configure before you begin.

It also changes how you debug. When a GLB renders incorrectly, the fault is in the file: a material exported with the wrong metalness, a texture in an unsupported codec, an animation stripped by whatever last touched it. Assets failing to resolve — the most common category of problem in browser-based 3D — simply cannot happen here.

Step by step

  1. Open the GLB Viewer

    Load GLBKit's GLB Viewer. The workspace opens on the Viewer tab, with the model empty until you provide a file.

  2. Drop in the .glb file

    Drag the file onto the drop zone or use Browse Files. A GLB carries its geometry, materials, textures and animations inside one container, so there are no companion files to select alongside it.

  3. Read the file in the Info panel

    Open Info to see the mesh, material and texture names the file contains, the animation clips it carries, and the node hierarchy. Because a GLB is self-contained, an empty Materials or Textures block means the source genuinely had none — not that something failed to resolve.

  4. Frame it with the Camera panel

    Pick a projection, one of the seven view presets, a field of view and a zoom level. Reset Camera returns perspective, a 40° field of view, 1x zoom and the isometric preset.

  5. Capture the result

    Open Screenshot and choose PNG or JPEG output, a resolution up to 3840 × 2160, and a transparent, white, black background. Click Capture Screenshot, then Download Image.

What the Info panel reports

Info is a report on the file, not a control. It opens with a card showing the filename, detected format and file size, followed by five collapsible sections — Meshes, Materials, Textures, Animations and Scene Hierarchy. Everything is collapsed by default, so the panel shows you the summary and nothing else until you ask.

Info panel sections and what an empty one means for a GLB
Info panel sections and what an empty one means for a GLB
SectionReportsIf it is empty
MeshesMesh and submesh names from the fileThe GLB contains no mesh data
MaterialsMaterial names referenced by the meshesThe exporter wrote geometry without materials
TexturesTexture names and the texture types in useNo image textures are embedded in the file
AnimationsClip names carried by the fileThe GLB has no animation
Scene HierarchyThe node tree as it arrivedThe file has no usable node hierarchy

Because a GLB resolves everything internally, those empty states are trustworthy. On a manifest-based format the same emptiness often means a missing file; on a GLB it means the data was never there.

For a deeper inspection of geometry, materials, textures, memory and bounds, you can also use the 3D Model Analyzer.

GLBKit Camera panel open beside a model in the viewport, showing the Camera Type perspective and orthographic buttons, the View Preset grid, the Field of View slider and the Zoom slider.
The Camera panel. View Preset is a fixed-angle grid; Field of View and Zoom are the two numeric controls that decide how much of the model is in frame.

Camera and framing

Dragging orbits around a point near the model's centre, which is fine for exploring and awkward for reproducing. The Camera panel gives you the same view twice, in numbers rather than by hand.

Camera panel controls
Camera panel controls
ControlBehaviour
Camera TypePerspective or Orthographic. Orthographic hides the field of view slider.
View Preset7 fixed angles: Front, Back, Top, Bottom, Left, Right, Isometric.
Field of View20° to 100°, default 40°. Perspective only. Lower values flatten perspective, higher values exaggerate it.
Zoom0.25x to 5x, default 1x
Reset CameraPerspective, 40° field of view, 1x zoom, isometric preset.

The Recenter Camera button in the top-right toolbar is the same operation as Reset Camera. It reframes the loaded model without changing the projection or zoom, which is what you want after panning somewhere unhelpful.

Lighting and material

A GLB carries physically based values — base colour, metalness, roughness, opacity — so how it looks depends heavily on what is lighting it. GLBKit splits that into two panels.

Lights

The Lights panel uses three named lights: Key, Fill, Rim. Key is the dominant source, Fill lifts the shadow side, and Rim draws an edge along the silhouette. Intensity runs 0 to 5 and position is adjusted on X, Y and Z axes from −20 to 20. Shadows are off by default and can be enabled per light.

Environment

The Environment panel applies an HDRI, which lights the scene from every direction at once and provides the reflections that make a metal read as metal. Four presets are available: Studio, Warehouse, Sunset, Outdoor. Intensity runs 0 to 3 and Rotation 0 to 360 degrees.

These two panels overlap, and that is deliberate — but it also causes the most common surprise. Switching HDRI presets changes the whole lighting environment, not just the background image, so a glossy material looks different under each one. When you are judging a material rather than styling a scene, turn HDRI off and work from the Lights panel alone.

Material overrides

For diagnosis, the Material panel is more useful than either. Select a material by name from the list at the top of the panel and override base color, metalness, roughness, opacity. A surface that corrects itself under an override had a texture problem. One that does not had a material problem.

If you want a dedicated image after adjusting the scene, the GLB Screenshot tool lets you capture the current viewport with dedicated format, resolution and background settings.

Capture settings

Capture settings live in one panel and cover three decisions. Nothing here is a separate rendering pass — the screenshot is taken from the viewport you have already framed.

Screenshot panel settings
Screenshot panel settings
SettingOptions
Image FormatPNG or JPEG
Resolution1280 × 720 (HD), 1920 × 1080 (Full HD), 3840 × 2160 (4K)
BackgroundTransparent, White, Black

Transparent requires PNG, because JPEG has no alpha channel; pick White or Black when choosing JPEG. Note that a transparent capture ignores the Background panel entirely — the two are independent, and the screenshot setting wins for the exported image.

For the complete capture workflow, see the How to Take GLB Screenshots guide.

Playing animations

Animations are stored inside the GLB alongside the geometry, which is the reason a single GLB can be handed to a browser and animate without a second file. Two things in the interface look related and are not.

ANIMATION buttonon the bottom bar toggles a turntable auto-rotation of the model. It is a display effect on the camera, unrelated to the file's own clips.

The file's actual clips are reported by the Info panel with each clip's name and duration. That is where to confirm a GLB arrived with its animation intact — a character that should walk and shows zero clips has failed somewhere between the modelling tool and this viewer, usually at an export step.

When a clip is listed but nothing visibly moves, the usual cause is that the animation targets bones rather than node transforms, which needs a skinned mesh and a skeleton for the viewer to bind. Also make sure the ANIMATION button is not left on, because a rotating model makes it easy to miss a subtle motion in the rig itself.

GLB or GLTF: which should you open

Both formats describe the same scene. The choice is about packaging, not capability.

GLB and GLTF compared for opening and sharing
GLB and GLTF compared for opening and sharing
GLBGLTF
PackagingOne binary containerJSON manifest plus .bin and texture files
UploadA single fileThe whole folder, usually zipped
Failure modeNone — nothing external can be missingUntextured or incomplete geometry when references break
Version controlOpaque binary; merges are unreviewableReadable JSON; diffs are meaningful
Best forDelivery, previews, web deploymentEditable source assets under version control

A practical pattern: author in GLTF so your exporter output stays diffable in review, then convert to GLB for anything that ships. The GLB to GLTF converter handles that direction, and the GLB vs GLTF guide covers the trade-offs in depth.

When something looks wrong

Geometry is there but untextured

Unusual for a GLB, and worth checking in this order: confirm the Textures section of the Info panel lists your images, then rule out a codec the browser cannot decode. If the textures are listed but do not appear, the exporter likely used a compressed texture format the viewer cannot render, and re-exporting with standard PNG or JPEG resolves it.

Everything is a flat grey

The scene has no materials. Open Info, expand Materials, and if the section is empty the GLB genuinely contains none — common for meshes that went through a mesh-repair or decimation step. Export from a tool that writes PBR materials, or accept the default material and override values in the Material panel for display purposes.

The upload is rejected

Confirm the file really ends in .glb and is under 150 MB. A truncated file — an interrupted download, or an export that was still writing when the process ended — passes the extension check and then fails to parse.

The render looks flat

Disable the HDRI and raise the key light instead. An even HDRI environment flattens contrast; a single directional key light with shadows restores form. Shadows are off by default in the Lights panel, and enabling them is often the single biggest improvement to a capture.

If you want to understand the model's geometry, materials, textures and memory before troubleshooting further, use the How to Analyze 3D Models guide.

FAQ

Why use a GLB viewer instead of a general 3D model viewer?

Because a GLB needs no assembly. It is a single binary container that carries the scene's geometry, PBR materials, embedded textures and animation in one file, so there is no missing-texture or unresolved-buffer failure mode to debug. If a GLB looks wrong in the viewer, the cause is in the file rather than in the way it was loaded.

How large a file can I open?

Uploads are capped at 150 MB and the drop zone displays the limit. For reference, a well-optimised GLB for a real-time scene is often single-digit megabytes; anything far larger is worth checking in the Analyzer panel before you open it.

Does the GLB Viewer modify my file?

No. Every panel in the workspace changes browser state only. Camera, Material, Background, Lights and Environment are display settings, and Screenshot produces a separate image. Reloading the model restores its original appearance.

Which environment presets can I apply?

Four HDRI presets are available: Studio, Warehouse, Sunset, Outdoor. Each is a different lighting environment rather than a colour filter, so switching between them changes how reflective surfaces read. Turn the HDRI toggle off to judge a material under the Lights panel alone.

Can I export the model to another format?

Yes. The Convert panel is part of the same workspace. Once a GLB is loaded it lists the targets available from it — GLTF, OBJ, STL, PLY, 3MF, FBX and OFF — and converts in the browser.

Is the GLB Viewer free to use?

Yes, and it needs no account. Opening, inspecting and capturing a model runs entirely in your browser.

Open the GLB Viewer

Drop in a .glb and the whole workspace opens around it: file contents, camera, materials, lighting, conversion and capture.

Was this guide helpful?