We use cookies on this site to enhance your user experience

The Decal object is an object which applies an image to a face of a BasePart.

How does a Decal work?

A Decal will apply an image to the BasePart it is parented to. The surface this image is applied to is dependent on the FaceInstance/Face property. The size of the decal is dependent on the size of the face, meaning the size and aspect ratio of a decal can be changed by changing its parent’s BasePart/Size.

The image a Decal applies is determined by its Decal/Texture property. Images can be uploaded to Roblox provided they adhere to the community guidelines. Information on how to upload images can be found Articles/How to upload a Decal|here.

Alternatives to Decals

Although Decals have a wide variety of applications, in some cases developers may wish to pick one of the following classes instead.

  • For repeated tiled textures, the Texture object should be used
  • To apply GUI elements, the SurfaceGui object should be used
  • If the effect of lighting on the image needs to be altered, the SurfaceGui object should be used


Name Type Description

The DataType/Color3 tint of the Decal.


Acts as a multiplier for the Decal's Decal/Transparency property. The effects are only visible to the local player.


The ContentId of the image to be applied by the Decal.


Determines the transparency of the Decal with 0 being completely opaque and 1 completely transparent.

Inherited from Instance , FaceInstance

Archivable ClassName DataCost Name Parent RobloxLocked Face