> ## Documentation Index
> Fetch the complete documentation index at: https://docs.projectreal.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# getreferencedby

> Returns cached Instance values whose supported reference properties point to the provided Instance. The argument must be an Instance.

Returns cached Instance values whose supported reference properties point to the provided Instance. The argument must be an Instance.

## Syntax

```lua theme={null}
getreferencedby(instance: userdata): table
```

## Aliases

* `getreferences`

## Arguments

| Name       | Type       | Required | Description                               |
| ---------- | ---------- | -------- | ----------------------------------------- |
| `instance` | `userdata` | Yes      | Target Instance to search references for. |

## Returns

| Name        | Type    | Description                                                    |
| ----------- | ------- | -------------------------------------------------------------- |
| `instances` | `table` | New array table of matching registered Instance object values. |

## Example

Find values that reference a specific Instance.

```lua theme={null}
local references = getreferencedby(workspace)

for _, value in ipairs(references) do
    print(value)
end
```