Vi3W
Skip to content

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

A low-poly glass bottle split down the middle: one half clear see-through glass, the other half wrongly solid
Illustration. Transparency is the most common SurfaceAppearance surprise.

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 Color underneath
  • Transparency: Cut through: you see what's behind the mesh
  • TintMask: Control where SurfaceAppearance.Color tints
  • **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.

A metal robot head prop with shiny metallic panels and glowing emissive eyes
Illustration. Metalness, roughness and emissive maps working together.

Roblox adds two tips for Transparency mode:

  • For hard-edged cutouts like leaves or fences, set the MeshPart's Transparency to 0.
  • For semi-transparent areas like glass, set the MeshPart's Transparency to 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 Color with 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