OBJ File Has No Colour or Texture? The Missing MTL Fix
Also in:DeutschEspañolFrançaisPortuguês日本語Türkçe

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 do you send an OBJ with its colours?
- Collect every file. The .obj, the .mtl it names after
mtllib, and every image the .mtl names aftermap_Kd(and othermap_lines). - Keep them in one folder. Many exporters write paths relative to the .obj. If the .mtl says
textures/scales.png, keep that subfolder. - Check the names. Open the .mtl in a text editor. If it points to
Scales.PNGand the file isscales.png, some programs on some systems will not find it, so make them match exactly. - Zip the folder and send the zip. Chat apps and email will not keep loose files together, and some rename them.
- 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.

