Material ID Colour Mapper
3D Artist Evenly hue-spaced IDs for clean matte passesCreate a colour legend for named material IDs. Copy the values or download a text legend, then apply and check the assignments in your 3D or compositing workflow.
Enter material names on the left and generate evenly spaced colour IDs.
A quick visual guide
Material ID Colour Mapper
01Input
Use the source files or project information described below.
02Adjust
Change the relevant controls, then compare against your source.
03Check the result
Inspect the result and the stated limits before you use it.
Open each step for the practical check. Diagram, not a generated result.
Updated 9 November 2026 by XO3D Labs
Make a material ID colour legend
Create a colour legend for named material IDs. Copy the values or download a text legend, then apply and check the assignments in your 3D or compositing workflow. Each name gets a hex colour value and an RGB value. The tool does not bake an image, assign materials to a mesh or create a render pass.
How to make and use a material ID legend
- Enter one material name per line.
- Choose the options: ignore duplicates, saturation, lightness, hue start and the high contrast spread.
- Generate the IDs and review each name and value.
- Copy the legend or download the .txt file, then apply each colour to the matching material in your 3D or compositing application.
Keep a version of the legend with the asset, and review it before anyone makes masks from it. The legend is text. The ID image or render pass is made elsewhere, in the software that renders the scene.
What goes in and what comes out
| Item | What it is |
|---|---|
| Names | One material name per line. Blank lines are skipped. |
| Duplicate filter | When on, a repeated name is dropped, ignoring capitals. The first one keeps its place. |
| Saturation, lightness, hue start | Saturation 40 to 100, lightness 35 to 75, hue start 0 to 359. Defaults are 78, 55 and 0. |
| Hex colour value | Shown for each name, for example #E63333. Click a swatch or the value to copy it. |
| RGB | 8-bit integers, 0 to 255. |
| Normalised RGB 0 to 1 | The 8-bit values divided by 255. Shown to two decimals; clicking copies three. |
| Copy legend and .txt download | Number, hex, 8-bit RGB and name for every ID. The normalised values are not included. |
| Not produced | A mesh, a UV texture, a rendered ID pass or an application material file. |
The values are labels for assignment. They do not describe a physical material.
How far apart are the colours?
Colours are distributed around the hue wheel, 360 divided by the number of names apart. The high contrast spread reorders them so that names next to each other in the list tend to get hues further apart. With a long list the hues get closer together, and some IDs can be hard to tell apart.
Check that the IDs you need are distinguishable for your task, in the software and on the screens you will use. Colour-vision differences, colour management and compression can all make two IDs harder to separate.
Save the legend before you change the list
Each colour depends on the number of names and each name's position. Adding, removing or reordering a name, or changing a slider, can give materials that were already assigned a new colour. A pass made with the old legend will not match the new one.
In the example below, adding "strap" to the end of the list changes button from #3333E6 to #33E6E6 and lens from #33E633 to #8CE633. Shell stays #E63333.
- Save the approved legend before you edit the list.
- Use versioned file names, such as product-ids-v2.txt.
- Name one owner for the legend in the handoff.
- Compare every name and value with the existing scene before you replace a legend.
RGB 0 to 1 is not linear
The 0 to 1 values are the 8-bit RGB values divided by 255. That is a change of scale, not a conversion from sRGB to linear colour, even though the copy message calls them "linear-ish". Before you type them into a material, check whether your destination expects sRGB or linear input and how its colour management is set.
The legend shows two decimal places, and clicking the value copies three. Use the copied value, or the 8-bit RGB, when precision matters.
Worked example: shell, button and lens
Three fictional part names, entered in this order with the default settings, gave this legend on 9 November 2026. Your values will match only with the same names, order and settings.
| Name | Hex colour value | RGB | RGB 0 to 1 (copied) |
|---|---|---|---|
| shell | #E63333 | 230, 51, 51 | 0.902, 0.200, 0.200 |
| button | #3333E6 | 51, 51, 230 | 0.200, 0.200, 0.902 |
| lens | #33E633 | 51, 230, 51 | 0.200, 0.902, 0.200 |
In your application, render a small preview of the ID pass first. Check that each region shows its legend colour, that neighbouring regions stay separate, and that edges and UV seams are clean. Bake and render settings depend on that software.
Where to go next
- Explore material preparation tools for the maps that sit alongside an ID pass.
- Understand material finish values. An ID colour is a category, not a roughness or metalness value.
Guides for this tool
Frequently asked questions
Does this make an ID map?
No. It makes a named colour legend: one hex colour value and RGB value per material name. You assign the colours and create the ID pass or mask in your own 3D or compositing software.
What changes if I add a name?
Usually most of the colours. Hues are spaced by the number of names and given out by list position, so adding, removing or reordering names, or moving a slider, can give existing materials new colours. Save the approved legend before you edit the list.
Are the RGB 0 to 1 values linear?
No. They are the 8-bit values divided by 255, which is not a conversion from sRGB to linear. Check what input your destination expects and how its colour management is set.
Can I use the legend for an object ID pass?
Yes, as long as your software lets you set the colour of each ID yourself. The legend only names the colours; check the finished pass in that software.
How do I keep a handoff consistent?
Save the legend with the asset, give the file a version, and name the person who owns it. Before you replace a legend, compare every name and value with the scene that already uses it.