Vertex Color Layer

The Vertex Color Layer displays colour data stored in the mesh itself, rather than colour you set in Spline.

Many models carry a colour per vertex — sculpts painted in ZBrush or Blender, photogrammetry scans, point-cloud captures, or exports from CAD and generative tools. Without this layer that data is ignored and the object renders in a single flat colour.

---

Adding the layer

Select the imported object, then in the Material section of the inspector click + and choose Vertex Color.

There is nothing to configure — the layer shows what the mesh already contains.

---

When it does nothing

If the object doesn't change, its mesh has no vertex colour data. That's common:

• Primitives created in Spline have no vertex colours — use a Color Layer or Gradient Layer instead.
• Some formats and exports drop it. If your model looked coloured in the tool you made it in, check that vertex colours were enabled on export.
• Textured models usually carry their colour in an image rather than in the mesh — use an Image Layer for those.

See How to Import Content for supported formats.

---

Tips

• Stack it. Add a Lighting Layer above it so the baked colours still respond to your scene's lights instead of looking flat.
• Scans: vertex colours are how most photogrammetry and point-cloud captures carry their appearance, so this is usually the first layer to add to one.
• The layer costs almost nothing to render — it's reading data the mesh already carries.