> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# ApplyTextureToMesh - ComfyUI Built-in Node Documentation

> This node attaches baked texture images to a mesh's UV layout so they can be exported together with the mesh by the SaveGLB node.

This node attaches baked texture images to a mesh's UV layout so they can be exported together with the mesh by the SaveGLB node. Connect the same UV-unwrapped mesh you used for baking, along with the baked image maps. Optional metallic, roughness, and occlusion maps are packed into a single ORM texture, and supplying a normal map also stores the smooth normals and tangents needed for correct shading.

## Inputs

| Parameter    | Description                                                                                                                                                                                                | Data Type | Required | Range |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | -------- | ----- |
| `mesh`       | The UV-unwrapped mesh that the baked textures will be attached to. Must be the same mesh used during baking; an error is raised if the mesh has no UVs.                                                    | MESH      | Yes      | —     |
| `base_color` | The baked base color image. Stored as the mesh's texture and clamped to the 0-1 range.                                                                                                                     | IMAGE     | Yes      | —     |
| `metallic`   | The baked metallic map. Used as the blue channel of the combined ORM texture; defaults to 0 when not provided.                                                                                             | IMAGE     | No       | —     |
| `roughness`  | The baked roughness map. Used as the green channel of the combined ORM texture; defaults to 1 when not provided.                                                                                           | IMAGE     | No       | —     |
| `occlusion`  | The baked ambient occlusion map. Used as the red channel of the combined ORM texture; defaults to 1 when not provided. When provided, the ORM texture is also marked as the occlusion texture for SaveGLB. | IMAGE     | No       | —     |
| `normal_map` | The baked tangent-space normal map. When provided, the node recomputes the per-vertex tangent basis and exports smooth vertex normals so the normal map shades correctly.                                  | IMAGE     | No       | —     |

Note: When any of `metallic`, `roughness`, or `occlusion` is connected, all three are packed into a single glTF ORM texture with channels R = occlusion, G = roughness, B = metallic. Missing maps are filled with defaults (occlusion 1, roughness 1, metallic 0), and maps with different resolutions are resized to the largest width and height. When `normal_map` is connected, the mesh's normals are replaced with computed smooth vertex normals and a tangent basis is added. UV coordinates that fall outside the \[0,1] range are uniformly scaled into \[0,1] while preserving aspect ratio.

## Outputs

| Output Name | Description                                                                                     | Data Type |
| ----------- | ----------------------------------------------------------------------------------------------- | --------- |
| `mesh`      | The input mesh with the texture images attached to its UV layout, ready to be saved by SaveGLB. | MESH      |

> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/ApplyTextureToMesh/en.md)

***

**Source fingerprint (SHA-256):** `f91985ef686beddccc41a72614b3d263b4e0d9f1a156db6017d620de26d7b6cf`