Labels are GuiObjects that let you display customizable text and images on‑screen or in‑experience. 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 an experience.
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 an experience.
Creating 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.
Hover over StarterGui and click the ⊕ button. A contextual menu displays.
From the menu, insert a ScreenGui.
Select the new ScreenGui and add a label.
Hover over ScreenGui and click the ⊕ button. A contextual menu displays.
From the menu, insert a TextLabel or ImageLabel.
Creating 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, select StarterGui and add a SurfaceGui.
Hover over StarterGui and click the ⊕ button. A contextual menu displays.
From the menu, insert a ScreenGui.
Select the new SurfaceGui and add a label.
Hover over SurfaceGui and click the ⊕ button. A contextual menu displays.
From the menu, insert a TextLabel or ImageLabel.
If you don't see the button, try choosing a different face in the Face property of the SurfaceGui.
Adjusting 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.
Text Filtering
Applied to various sources and inputs, text filtering prevents users from seeing inappropriate language and personally identifiable information such as phone numbers. Roblox automatically filters common text outputs such as messages that have passed through in-experience text chat, but you are responsible for filtering any displayed text that you don't have explicit control over, including characters/strings that are displayed on text labels.
Because filtering is crucial for a safe environment, Roblox actively moderates the content of experiences to make sure they meet community standards. If Roblox receives reports or automatically detects that your experience doesn't apply text filtering, then the system removes the experience until you add filtering.