Learn
Engine Class
ImageButton


API Reference
Properties
HoverImage
Read Parallel
Capabilities: UI
ImageButton.HoverImage:ContentId

HoverImageContent
Read Parallel
Capabilities: UI
ImageButton.HoverImageContent:Content

Image
Read Parallel
Capabilities: UI
ImageButton.Image:ContentId
Code Samples
Image Hover Lock
local imageLabel = script.Parent
-- The images in this example are 64x64
imageLabel.Size = UDim2.new(0, 64, 0, 64)
local function unlock()
imageLabel.Image = "rbxassetid://284402785" -- Unlocked padlock (64x64)
imageLabel.ImageColor3 = Color3.new(0, 0.5, 0) -- Dark green
end
local function lock()
imageLabel.Image = "rbxassetid://284402752" -- Locked padlock (64x64)
imageLabel.ImageColor3 = Color3.new(0.5, 0, 0) -- Dark red
end
-- Connect events; our default state is locked
imageLabel.MouseEnter:Connect(unlock)
imageLabel.MouseLeave:Connect(lock)
lock()

ImageColor3
Read Parallel
Capabilities: UI
ImageButton.ImageColor3:Color3
Code Samples
Image Hover Lock
local imageLabel = script.Parent
-- The images in this example are 64x64
imageLabel.Size = UDim2.new(0, 64, 0, 64)
local function unlock()
imageLabel.Image = "rbxassetid://284402785" -- Unlocked padlock (64x64)
imageLabel.ImageColor3 = Color3.new(0, 0.5, 0) -- Dark green
end
local function lock()
imageLabel.Image = "rbxassetid://284402752" -- Locked padlock (64x64)
imageLabel.ImageColor3 = Color3.new(0.5, 0, 0) -- Dark red
end
-- Connect events; our default state is locked
imageLabel.MouseEnter:Connect(unlock)
imageLabel.MouseLeave:Connect(lock)
lock()

ImageContent
Read Parallel
Capabilities: UI
ImageButton.ImageContent:Content

ImageRectOffset
Read Parallel
Capabilities: UI
ImageButton.ImageRectOffset:Vector2
Code Samples
Image Animation using Spritesheet
-- Place this in an ImageLabel/ImageButton with size 256x256
local imageLabel = script.Parent
-- The following image is 1024x1024 with 12 frames (256x256)
-- The frames play an animation of a man throwing a punch
imageLabel.Image = "rbxassetid://848623155"
imageLabel.ImageRectSize = Vector2.new(256, 256)
-- The order of the frames to be displayed (left-to-right, then top-to-bottom)
local frames = {
Vector2.new(0, 0),
Vector2.new(1, 0),
Vector2.new(2, 0),
Vector2.new(3, 0),
Vector2.new(0, 1),
Vector2.new(1, 1),
Vector2.new(2, 1),
Vector2.new(3, 1),
Vector2.new(0, 2),
Vector2.new(1, 2),
Vector2.new(2, 2),
Vector2.new(3, 2),
}
-- Animate the frames one at a time in a loop
while true do
for _, frame in ipairs(frames) do
imageLabel.ImageRectOffset = frame * imageLabel.ImageRectSize
task.wait(0.1)
end
end

ImageRectSize
Read Parallel
Capabilities: UI
ImageButton.ImageRectSize:Vector2
Code Samples
Image Animation using Spritesheet
-- Place this in an ImageLabel/ImageButton with size 256x256
local imageLabel = script.Parent
-- The following image is 1024x1024 with 12 frames (256x256)
-- The frames play an animation of a man throwing a punch
imageLabel.Image = "rbxassetid://848623155"
imageLabel.ImageRectSize = Vector2.new(256, 256)
-- The order of the frames to be displayed (left-to-right, then top-to-bottom)
local frames = {
Vector2.new(0, 0),
Vector2.new(1, 0),
Vector2.new(2, 0),
Vector2.new(3, 0),
Vector2.new(0, 1),
Vector2.new(1, 1),
Vector2.new(2, 1),
Vector2.new(3, 1),
Vector2.new(0, 2),
Vector2.new(1, 2),
Vector2.new(2, 2),
Vector2.new(3, 2),
}
-- Animate the frames one at a time in a loop
while true do
for _, frame in ipairs(frames) do
imageLabel.ImageRectOffset = frame * imageLabel.ImageRectSize
task.wait(0.1)
end
end

ImageTransparency
Read Parallel
Capabilities: UI
ImageButton.ImageTransparency:number

IsLoaded
Read Only
Not Replicated
Read Parallel
Capabilities: UI
ImageButton.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))

PressedImage
Read Parallel
Capabilities: UI
ImageButton.PressedImage:ContentId

PressedImageContent
Read Parallel
Capabilities: UI
ImageButton.PressedImageContent:Content

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

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

SliceCenter
Read Parallel
Capabilities: UI
ImageButton.SliceCenter:Rect

SliceScale
Read Parallel
Capabilities: UI
ImageButton.SliceScale:number

TileSize
Read Parallel
Capabilities: UI
ImageButton.TileSize:UDim2

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