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
| Name | Value | Description |
|---|---|---|
| Stretch | 0 | The image is stretched to fit within the element. |
| Slice | 1 | 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. |
| Tile | 2 | 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). |
| Fit | 3 | The image is scaled fit within the element X or Y dimension (whichever fits first). |
| Crop | 4 | The image is cropped to fit within the element. |
Stretch
The image is stretched to fit within the element.
| Field | Value |
|---|---|
| value | 0 |
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.
| Field | Value |
|---|---|
| value | 1 |
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).
| Field | Value |
|---|---|
| value | 2 |
Fit
The image is scaled fit within the element X or Y dimension (whichever fits first).
| Field | Value |
|---|---|
| value | 3 |
Crop
The image is cropped to fit within the element.
| Field | Value |
|---|---|
| value | 4 |