Labels

Labels are GuiObjects that allow you to display customizable text and images within a ScreenGui or SurfaceGui. There are two types of labels:

  • A TextLabel is a rectangle with text that you can style through customizable properties. This is the main way to display text in an experience.

  • An ImageLabel is a rectangle with an image that you can style through customizable properties. This is the main way to 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:

  1. 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.

  2. 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.

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:

  1. In the Explorer window, select StarterGui and add a SurfaceGui.

    1. Hover over StarterGui and click the ⊕ button. A contextual menu displays.

    2. From the menu, insert a ScreenGui.

  2. Select the new SurfaceGui and add a label.

    1. Hover over SurfaceGui and click the ⊕ button. A contextual menu displays.

    2. From the menu, insert a TextLabel or ImageLabel.

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.