Skip to content

OBJ File Has No Colour or Texture? The Missing MTL Fix

Enes Vural
Watch it in 30 secondsWho stole my dragon's colours?!Watch on YouTube

An OBJ file stores only the shape. Colours live in a separate .mtl file, and textures in image files that the .mtl names. Send just the .obj, or move it away from those files, and the model opens grey. To keep the look, send the .obj + .mtl + images together in one zip, with matching file names, or convert to 3MF or GLB, which pack colour into one file. For a single-colour print, none of this matters: the slicer only uses the shape.

A friend sends you a painted dragon as an OBJ. It looked great in their screenshot. On your side it is a grey lump. Nothing was lost in the chat app. The colours were never in the file you received.

I build Extrude, a 3D file viewer for phones, and OBJ is one of the formats people open with it alongside STL and 3MF. It is also the one that most often arrives “half”: the shape without the files that give it a look.

Why does an OBJ lose its colours?

Because OBJ splits a model across several files. The format was designed so that geometry and appearance live apart:

File What it holds
dragon.obj Vertices, faces, texture coordinates, normals
dragon.mtl Material names, colours, shine, and which images to use
scales.png, eyes.jpg The textures painted onto the surface

The .obj points to its material file with a line such as mtllib dragon.mtl, and each group of faces picks a material with usemtl. Inside the .mtl, a line like map_Kd scales.png says which image to wrap onto those faces. Paul Bourke’s long-standing references for the OBJ format and the MTL format list every keyword.

If any link in that chain is missing, the program falls back to a default material, which is usually grey.

How an OBJ finds its coloursdragon.objdragon.mtlscales.pngmtllibmap_Kdshapecolours, materialstextureBreak any arrow (missing file, renamed file, different folder) and the model opens grey.
The .obj only names its material file; the material file only names its images. All of them have to travel together.

How do you send an OBJ with its colours?

  1. Collect every file. The .obj, the .mtl it names after mtllib, and every image the .mtl names after map_Kd (and other map_ lines).
  2. Keep them in one folder. Many exporters write paths relative to the .obj. If the .mtl says textures/scales.png, keep that subfolder.
  3. Check the names. Open the .mtl in a text editor. If it points to Scales.PNG and the file is scales.png, some programs on some systems will not find it, so make them match exactly.
  4. Zip the folder and send the zip. Chat apps and email will not keep loose files together, and some rename them.
  5. Or convert it. 3MF and GLB keep colours inside a single file, so there is nothing to forget.

Myth: “OBJ can’t store colour”

It can, just not in the .obj itself. Materials and textures are part of the format; they simply live in companion files. Some programs also write a colour after each vertex (v x y z r g b), which keeps colour inside the .obj, but that is an unofficial extension and not every tool reads it. So if you receive a grey OBJ, ask for the .mtl and the images before assuming the model was never coloured.

Does colour matter for printing an OBJ?

For a single-colour printer, no. The slicer reads the faces, ignores materials, and prints the shape. What does matter is the same thing as with STL: OBJ has no unit, so check the size in millimetres before you slice.

For a multi-colour printer, the textures usually do not carry over as print colours anyway. Slicers such as Bambu Studio and PrusaSlicer let you paint or assign colours per part, and they save the result as 3MF. If you plan to print in colour, ask the designer for a 3MF, not an OBJ.

How do you check an OBJ on your phone?

Open it and look at the shape and size before anything else. Extrude (listed as STL Viewer on the App Store and Google Play) opens OBJ files offline on iPhone and Android, shows the model in 3D with its size in millimetres, and never uploads the file. It shows the geometry rather than the textures, which is exactly what a printer needs. On a computer, the OBJ viewer in your browser does the same, and the file stays on your machine.

Questions

Why is my OBJ file grey with no colours?

The colours are not in the .obj file. They live in a separate .mtl material file, and textures in image files next to it. If only the .obj was sent or the .mtl is in another folder, the program has nothing to colour the model with.

What is an MTL file?

A small text file that lists the materials an OBJ uses: their colours, shine and the names of any texture images. The OBJ points to it with a line that starts with mtllib, and each part picks a material with usemtl.

How do I send an OBJ with its colours?

Put the .obj, the .mtl and every texture image in one folder, check the file names match what the .mtl lists, and zip the folder. Or convert it to 3MF or GLB, which keep colour inside a single file.

Does colour in an OBJ matter for 3D printing?

Only on multi-colour printers, and even then the slicer usually asks you to paint or assign colours again. A single-colour FDM print ignores materials entirely; the shape is what counts.

Can I open an OBJ file on my phone?

Yes. Extrude (listed as STL Viewer on the App Store and Google Play) opens OBJ files offline on iPhone and Android and shows the shape and size. Like many viewers, it shows the geometry rather than the textures.

Open 3D files on your phone

Extrude is free and keeps files on your device. Listed as “STL Viewer”.

Download on the App StoreGet it on Google Play
Enes Vural

Written by

Enes Vural

Founder and developer

Enes builds Extrude, the phone app listed as STL Viewer on the App Store and Google Play. He writes the file parsers and the native 3D viewers (Filament on Android, SceneKit on iOS), and ships features people ask for by email. He writes about 3D file formats, viewing and checking models on a phone, and preparing parts for printing.