GetGuiObjectsAtPosition has bad code example

There are three problems with the example code at the BasePlayerGui/GetGuiObjectsAtPosition code example.

  • The code example uses pairs in place of ipairs for array-like loops (When using GetChildren)
  • The code example checks against GUIs that inheritt GuiButton, not GuiObject as the documentation suggests.
  • The code example uses Remove instead of Destroy

To fix these issues, I propose the following changes to the code example:

local UserInputService = game:GetService("UserInputService")

 -- Get the LocalPlayer’s PlayerGui folder
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local PlayerGui = player:WaitForChild("PlayerGui")

 -- Create a Folder and ScreenGui to contain the highlight Frames
local Highlights ="Folder")
Highlights.Name = "Highlights"
Highlights.Parent = PlayerGui
local HighlightsContainer ="ScreenGui")
HighlightsContainer.Name = "Container"
HighlightsContainer.Parent = Highlights
HighlightsContainer.DisplayOrder = 99999

  -- Deletes all GUIs in HighlightsContainer
local function deleteHighlights()
	local highlights = HighlightsContainer:GetChildren()

-	for _, highlight in pairs(highlights) do	
+	for _, highlight in ipairs(highlights) do
-		highlight:Remove()
+		highlight:Destroy()

 -- Creates a semi-transparent yellow Frame on top of the gui with the same AbsoluteSize and AbsolutePosition
local function highlightAsFrame(gui)
	local highlight ="Frame")
	highlight.Name = "Highlight"
	highlight.Parent = HighlightsContainer
	highlight.Size =, gui.AbsoluteSize.X, 0, gui.AbsoluteSize.Y)
	highlight.Position =, gui.AbsolutePosition.X, 0, gui.AbsolutePosition.Y)
	highlight.BackgroundColor3 =, 255/255, 10/255) -- Yellow
	highlight.BackgroundTransparency = 0.75
	highlight.BorderSizePixel = 0
	highlight.LayoutOrder = gui.LayoutOrder -1

 -- Use GetGuiObjectsAtPosition to get and highlight all GuiObjects at the input’s position
local function highlightGui(input, gameProcessed)
	local pos = input.Position
	local guisAtPosition = PlayerGui:GetGuiObjectsAtPosition(pos.X, pos.Y)
-	for _, gui in pairs(guisAtPosition) do
+	for _, gui in ipairs(guisAtPosition) do
-		if gui:IsA("GuiButton") then
+		if gui:IsA("GuiObject") then
			local highlight = gui:Clone()

 -- Fire highlightGui on InputBegan if input is of type MouseButton1 of Touch
local function InputBegan(input, gameProcessed)
	local inputType = input.UserInputType
	local touch = Enum.UserInputType.Touch
	local mouse1 = Enum.UserInputType.MouseButton1
	if inputType == touch or inputType == mouse1 then
		highlightGui(input, gameProcessed)


Note: I had to add a space at the start of each comment line, otherwise diff will mark it as line removed.


One more thing: it also uses the deprecated :Remove instead of :Destroy.

Thanks! I didn’t even spot that. Updated the original post to fix that issue!

1 Like

Thanks for reporting this - I’ve added it to our todo list!


I see changes live on the page, however, I think you may have misinterpreted what I meant.


The + symbols should be removed and any line that starts with a - should be deleted.

The code should look something alike

for _, gui in ipairs(guisAtPosition) do
    if gui:IsA("GuiObject") then

(the same issue applies to lines 21-24 of the current code)


I was so confused when I saw this on the website yesterday, good to know it’s just a mistake on Developer Relations part.

Hah - yep I can see there’s still an issue as well! Flagging again with the team. Thanks for the patience!