Text & image labels

Labels are GuiObjects that let you display customizable text and images on‑screen or in-game. There are two types of labels:

A TextLabel is a rectangle with text that you can style through customizable properties. This is the primary way to display text in a game.
An ImageLabel is a rectangle with an image asset that you can style through customizable properties. Alongside textures and decals, this lets you display images in a game.

Create labels on the screen

Labels on a screen are useful for things like displaying images of characters with dialog.

To add a label to a screen:

In the Explorer window, select StarterGui and add a ScreenGui.
1. Hover over StarterGui and click the ⊕ button. A contextual menu displays.
2. From the menu, insert a ScreenGui.
Select the new ScreenGui and add a label.
1. Hover over ScreenGui and click the ⊕ button. A contextual menu displays.
2. From the menu, insert a TextLabel or ImageLabel.

Create labels on part faces

Labels on a part are useful for things like creating billboards, posters, and wallpaper.

To add a label to the face of a part:

In the Explorer window, insert a SurfaceGui onto the part.
1. Hover over the part instance and click the ⊕ button. A contextual menu displays.
2. From the menu, insert a SurfaceGui.
Select the new SurfaceGui and add a label.
1. Hover over the SurfaceGui and click the ⊕ button. A contextual menu displays.
2. From the menu, insert a TextLabel or ImageLabel.

Note

If you don't see the button, try choosing a different face in the Face property of the SurfaceGui.

Adjust ImageLabel properties

All images within an ImageLabel must be assets that have been imported to Studio. While the image automatically scales to fit the area of the rectangle, the image looks best when it displays at its native resolution.

You can customize the visual appearance of an image with the following properties:

For example, to display only the image and hide the rectangle, set the BackgroundTransparency property to 1.