---
schema_version: "1"
id: 6bbadcf6c9d5c2c6ba225e64260a2185bfd043f89ca672fe621afa44f74dad79
title: find()
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform/aura-platform/guides/aura/ref-jsapi/ref-jsapi-component-find.md
canonical_url: https://developer.salesforce.com/docs/platform/aura-platform/guide/ref-jsapi-component-find.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: c57e73cdce3891bf00ca4e0eaed9a9e92679f9cbf5347d40f739c75f39335631
products:
  - Lightning Aura Components Developer Guide
  - Platform Developer Content
---

# find()

Locates a component using its local ID (`aura:id`).

Returns different types depending on the result.

1.  If the local ID is unique, returns the component.
2.  If there are multiple components with the same local ID, returns an array of the components.
3.  If there is no matching local ID, returns `undefined`.

## Signature

`find(String | Object name)`

## Parameters

**_name_:** Type: `String | Object`. If name is an object, return instances of it. Otherwise, finds a component using its `aura:id`.

**See Also**  


-   [Finding Components by ID](https://developer.salesforce.com/docs/platform/aura-platform/js-cb/js-cb-find-by-id.md)