4 min read

Source: Roblox Creator Hub · CC BY 4.0 · View source · Code samples: MIT Imported 2026-10-03. Formatting adapted for this site.

Texture specifications

A texture is a digital image applied to the surface of a 3D object to simulate and enhance its visual appearance. Roblox supports various texture types that you import with a custom 3D object, or upload directly as individual image files. For details on implementing basic textures, see textures and decals.

Roblox also supports physically-based rendering (PBR) textures which override a mesh's existing TextureID and can be used to create immersive environments and objects.

Note

For information on how to properly connect textures to your model in Blender and Maya for import into Studio, see Blender / Maya texture settings.

See the following requirements when creating your own basic and advanced textures:

• File formats — File formats for textures that are uploaded separately in Studio must be submitted as a .png, .jpg, .tga, or .bmp.

• Resolution — Roblox supports up to 4096×4096 pixel texture resolutions (4K). As a game loads, the engine automatically starts with lower quality versions of the texture and ramps up quality based on device resources. Even still, manually sizing textures before you upload them can improve memory usage in some situations. Consider the following general guidance:

  • For smaller 5×5 stud objects, use 256×256 texture resolutions.
  • For medium 10×10 stud objects, use 512×512 texture resolutions.
  • For larger 20×20 stud objects, use 1024×1024 texture resolutions.
  • See PBR texture budgets for similar guidances with PBR texture maps.

• Single material — Mesh objects can only have one material assigned.

Note

Roblox default materials follow a similar texel resolution pattern:

• Parts display a 1024×1024 on an 8×8 stud face.
• Terrain displays 512×512 across 8×8 studs.

Surface appearance

You can add a surface appearance to your mesh in Studio to add PBR texture options. The SurfaceAppearance instance uses UV mapping, a form of texture mapping, to accurately map 2D images onto the mesh object.

Note

For information on how to properly connect PBR textures to your model in Blender and Maya for import into Studio, see Blender / Maya texture settings.

See the following requirements for SurfaceAppearance assets:

Texture Files

When possible, texture files should include the appropriate name affix and follow the appropriate image details:

PBR Texture Budget

Use an appropriate texture map size based on the asset you are texturing to optimize for visual quality and performance. As a general guideline, each asset should have a texture resolution of 256×256 for every 2×2×2 unit space the asset occupies. If larger than a 2×2×2 cube, use the next highest resolution. The following are some baseline texture sizing examples:

Note

When rendering many textures at the same time, Roblox may downsample textures to optimize for performance.

UV mapping

All textures use UV mapping, a 3D modeling process to project a 3D model's surface to a 2D image, or UV atlas. See the following requirements for UV mapping, especially if you're manually editing or optimizing your UV atlas:

• Single UV Set — Use a single UV set for each component, such as a humanoid or accessory. Studio doesn't allow for multiple UV sets.
• Coordinates — All UVs must be created within a 0:1 space.
• Overlaps — Overlapping UVs are allowed.
• Maximum Texture Resolution — Roblox supports up to 1024×1024 pixel spaces for texture maps.