> For the complete documentation index, see [llms.txt](https://wiki.thescriptersguild.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.thescriptersguild.com/scripting/nodes/objects/get-objects-by-label.md).

# Get Objects By Label

![](https://692276616-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN06Vv6nlwviUQ4hI2Kkd%2Fuploads%2Fgit-blob-bcfe6bb709bb03e5cbdfe69f2e34b024e2b9d0ef%2Fget-objects-by-label.png?alt=media)

## Description

Returns a list of dynamic objects from the scene with a matching Label in their Object Properties. Will not return objects that cannot be referenced by node graph.

## Node Type

Nodes fall into two basic categories: Data and Execution. This node supplies Data for an Execution node.

## Inputs

| Input | Type  | Required | Description               |
| ----- | ----- | -------- | ------------------------- |
| Label | Label | Yes      | Label to get objects for. |

## Outputs

| Output          | Type        | Description                               |
| --------------- | ----------- | ----------------------------------------- |
| New Object List | Object List | List of all valid objects with the label. |

\
\
**Contributors**

AddiCt3d 2CHa0s