2 min read

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

ScaleType

Controls the method by which an image is scaled to fill a ImageLabel, ImageButton, or VideoDisplay element. When the source image's dimensions differ from the element's rendered size, each ScaleType value determines whether the image is stretched uniformly to fill, tiled in a repeating grid, cropped to cover the element, letterboxed to fit without cropping, or divided into independently scalable 9-slice regions that preserve border details at any element size.

Items

NameValueDescription
Stretch0The image is stretched to fit within the element.
Slice19-Slice scaling: slice the image into 9 regions and apply different scaling rules to each region. The slice boundaries are determined by ImageLabel.SliceCenter or ImageButton.SliceCenter. See UI 9-Slice Design for more information.
Tile2The image is tiled to fit within the element. For example, if the element is twice the X dimension of the image, the image will appear twice (2 tiles).
Fit3The image is scaled fit within the element X or Y dimension (whichever fits first).
Crop4The image is cropped to fit within the element.

Stretch

The image is stretched to fit within the element.

FieldValue
value0

Slice

9-Slice scaling: slice the image into 9 regions and apply different scaling rules to each region. The slice boundaries are determined by ImageLabel.SliceCenter or ImageButton.SliceCenter. See UI 9-Slice Design for more information.

FieldValue
value1

Tile

The image is tiled to fit within the element. For example, if the element is twice the X dimension of the image, the image will appear twice (2 tiles).

FieldValue
value2

Fit

The image is scaled fit within the element X or Y dimension (whichever fits first).

FieldValue
value3

Crop

The image is cropped to fit within the element.

FieldValue
value4