Guides
Roblox SurfaceAppearance not working: transparency, loading and other fixes
Fix Roblox SurfaceAppearance problems: not loading, transparency not working, AlphaMode settings, emissive limits and why scripts can't change it.
3 min read

Quick answer
Why is my SurfaceAppearance not working in Roblox?
Check four things: it's a child of a MeshPart, not a Part or Model; its images are uploaded and approved; AlphaMode matches what you want, since Overlay shows the part colour through transparent areas; and you're not changing its maps from a script, which mostly isn't supported at runtime.
How SurfaceAppearance works
A SurfaceAppearance sits inside a MeshPart and replaces its texture with PBR maps: colour, normal, roughness, metalness and an emissive mask (surface appearance). It follows the mesh's UVs, so it's meant for one specific model, unlike a tiling MaterialVariant.
Problem 1: Nothing shows at all
- Wrong parent. It must be a direct child of a MeshPart. Inside a Part, a Model or a union it does nothing.
- Images not uploaded or not approved. Each map is an image asset. Freshly uploaded images may not appear until moderation finishes. Check them in Creator Hub.
- Wrong IDs. Make sure you used the image ID, not a decal ID.
- No UVs. A mesh without UVs can't place a texture.
Problem 2: Transparency doesn't work
This is the most common one, and it's about AlphaMode:
- **Overlay (default): Show the MeshPart's own
Colorunderneath - Transparency: Cut through: you see what's behind the mesh
- TintMask: Control where
SurfaceAppearance.Colortints - **Opaque (beta): Ignored
So with the default Overlay, a glass window with an alpha channel shows the part colour, not see-through glass. Set AlphaMode to Transparency.

Roblox adds two tips for Transparency mode:
- For hard-edged cutouts like leaves or fences, set the MeshPart's
Transparencyto 0. - For semi-transparent areas like glass, set the MeshPart's
Transparencyto at least 0.02.
Problem 3: Script changes don't apply
Roblox notes that you generally can't change SurfaceAppearance properties from scripts during a game, because the engine pre-processes them. The exception is SurfaceAppearance.Color for real-time tinting.
Workarounds:
- Prepare each version as its own SurfaceAppearance or MeshPart, and swap which one is visible.
- Use
Colorwith AlphaMode TintMask for colour changes. - For many colour variants, tint one texture rather than making new ones, as Roblox's performance guide recommends.
Problem 4: Looks different from Substance or Blender
Roblox's page notes that brightness and reflectivity can differ between Studio and texturing tools, and that roughness may need about 0.1 more to match at some angles. Check final looks in Studio under your actual lighting.
Problem 5: Normal map wrong or missing
Roblox only supports OpenGL tangent-space normal maps. See normal map not working.
Problem 6: Emissive too bright, or rejected
For Marketplace items, Roblox requires EmissiveStrength between 0 and 40. Use EmissiveTint to colour the glow.
Problem 7: SurfaceAppearance and MaterialVariant both present
If a MeshPart has both, Studio applies only the SurfaceAppearance (meshes). Remove one.
Models that arrive with their maps
Vi3W generates textured models with PBR materials, retopologises them, and exports GLB, FBX or OBJ. The Studio Importer can bring the textures in with the mesh. Check AlphaMode and the maps after import. Make a model in Vi3W.
Last reviewed

