Learn
Engine Class
ImageLabel


API Reference
Properties
Image
Read Parallel
Capabilities: UI
ImageLabel.Image:ContentId

ImageColor3
Read Parallel
Capabilities: UI
ImageLabel.ImageColor3:Color3

ImageContent
Read Parallel
Capabilities: UI
ImageLabel.ImageContent:Content

ImageRectOffset
Read Parallel
Capabilities: UI
ImageLabel.ImageRectOffset:Vector2

ImageRectSize
Read Parallel
Capabilities: UI
ImageLabel.ImageRectSize:Vector2

ImageTransparency
Read Parallel
Capabilities: UI
ImageLabel.ImageTransparency:number
Code Samples
Oscillate ImageTransparency
local RunService = game:GetService("RunService")
local imageLabel = script.Parent
local function onRenderStep()
-- Oscillate ImageTransparency from 0 to 1 using a sine wave
imageLabel.ImageTransparency = math.sin(workspace.DistributedGameTime * math.pi) * 0.5 + 0.5
end
RunService.RenderStepped:Connect(onRenderStep)

IsLoaded
Read Only
Not Replicated
Read Parallel
Capabilities: UI
ImageLabel.IsLoaded:boolean
Code Samples
Image Load Time
local imageLabel = script.Parent
local startTime = workspace.DistributedGameTime
-- Wait for the image to load
while not imageLabel.IsLoaded do
task.wait()
end
-- Measure and display how long it took to load
local deltaTime = workspace.DistributedGameTime - startTime
print(("Image loaded in %.3f seconds"):format(deltaTime))

ResampleMode
Read Parallel
Capabilities: UI
ImageLabel.ResampleMode:Enum.ResamplerMode

ScaleType
Read Parallel
Capabilities: UI
ImageLabel.ScaleType:Enum.ScaleType

SliceCenter
Read Parallel
Capabilities: UI
ImageLabel.SliceCenter:Rect

SliceScale
Read Parallel
Capabilities: UI
ImageLabel.SliceScale:number

TileSize
Read Parallel
Capabilities: UI
ImageLabel.TileSize:UDim2
Code Samples
Image ScaleType Demo
local imageLabel = script.Parent
-- Set the source image to be a 64x64 padlock
imageLabel.Image = "rbxassetid://284402752"
imageLabel.BackgroundTransparency = 0
imageLabel.BackgroundColor3 = Color3.new(1, 1, 1) -- White
imageLabel.ImageColor3 = Color3.new(0, 0, 0) -- Black
local function resizeInACircle()
for theta = 0, 2, 0.02 do
imageLabel.Size =
UDim2.new(0, 100 + math.cos(theta * 2 * math.pi) * 50, 0, 100 + math.sin(theta * 2 * math.pi) * 50)
task.wait()
end
end
while true do
-- Stretch simply stretches the source image to fit
-- the UI element's space
imageLabel.ScaleType = Enum.ScaleType.Stretch
resizeInACircle()
-- Tile will render the source image multiple times
-- enough to fill the UI element's space
imageLabel.ScaleType = Enum.ScaleType.Tile
imageLabel.TileSize = UDim2.new(0, 64, 0, 64)
resizeInACircle()
-- Slice will turn the image into a nine-slice UI.
imageLabel.ScaleType = Enum.ScaleType.Slice
imageLabel.SliceCenter = Rect.new(30, 30, 34, 34)
resizeInACircle()
end

©2026 Roblox Corporation. Roblox, the Roblox logo and Powering Imagination are among our registered and unregistered trademarks in the U.S. and other countries.