Guides
Roblox MaterialVariant and Material Manager: custom materials guide
Make custom materials in Roblox Studio with MaterialVariant: Material Manager steps, texture maps, Studs Per Tile, overrides, and SurfaceAppearance.
3 min read

Quick answer
What is a MaterialVariant in Roblox?
It's a custom version of a built-in material like Brick, Wood or Grass, with your own colour, normal, roughness and metalness maps. You make one in the Material Manager, and it lives in MaterialService. Apply it to selected parts, or set it as an override so it replaces that material everywhere in the place, terrain included.
MaterialVariant vs SurfaceAppearance
Roblox has two ways to put PBR textures on things, and they suit different jobs (materials):
- Made for: MaterialVariant: Tiling surfaces: floors, walls, rock, terrain; SurfaceAppearance: One specific UV-mapped mesh
- Works on: MaterialVariant: Parts, MeshParts, unions, terrain; SurfaceAppearance: MeshParts
- Texture repeats?: MaterialVariant: Yes, every N studs; SurfaceAppearance: No, it follows the mesh's UVs
- Physical properties: MaterialVariant: Yes: friction, density and more; SurfaceAppearance: No
- Where it lives: MaterialVariant: MaterialService; SurfaceAppearance: As a child of the MeshPart
Rule of thumb: walls, floors and ground use MaterialVariant; a modelled prop with its own texture uses SurfaceAppearance.
Make a custom material
- Open Material Manager from the Home or Model tab.
- Pick the base material to build on, such as Slate.
- Click Create Material Variant, and rename it in the inspector, for example
MossyStone. - Add texture maps: Color, Normal, Roughness and Metalness. Paste an asset ID or import an image. Square textures work best, and maps you leave empty stay blank.
- Set Studs Per Tile to control how often the texture repeats.
- Set Pattern to control how the tiling is laid out.

Apply it
- To selected parts: select them and click Apply to Selected Parts, or set the part's
MaterialVariantproperty. Studio sets the part'sMaterialto your base material. - Everywhere: turn on Set as Override. Your variant now replaces every use of that base material in the place, terrain included. It's a fast way to restyle a whole map.
Gotchas
- Names, not links. Parts store the variant's name. Rename the variant and parts stop finding it until you reapply it.
- Models and packages need the variant too. If you share a model that uses a custom material, the MaterialVariant must be in MaterialService in the new place, or the parts fall back to the base look.
- Physical properties stack. The engine uses the part's own custom physical properties first, then the variant's, then any override's, then the base material's.
Getting good tiling textures
- Tileable edges. The left edge must match the right, and the top the bottom, or you'll see a grid of lines.
- Size. 512 or 1024 is usually plenty, since the texture repeats. See Roblox texture size.
- Normal maps in OpenGL format. Roblox expects OpenGL-style normal maps (surface appearance). If bumps look inverted, flip the green channel. More in normal map not working.
- Roblox's generator. Studio's Assistant can generate materials from a prompt too. See Roblox Texture Generator.
Where meshes fit
MaterialVariants make walls and ground look rich, but props usually need their own UV-mapped textures with SurfaceAppearance. Vi3W generates props with their own texture, retopologised and exported as GLB, FBX or OBJ, to place on surfaces textured with your materials. Make a textured prop in Vi3W.
Last reviewed

