> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name: find()

# Method package: wixSearch

# Method menu location: wixSearch --> WixSearchBuilder --> find

# Method Link: https://dev.wix.com/docs/velo/apis/wix-search/wix-search-builder/find.md

# Method Description:

Returns the documents that match the search.

The `find()` function returns a Promise that resolves to the results found
 by the search and some information about the results. The Promise is
 rejected if any of the functions used to refine the search are invalid.

 If you build a search and don't refine it with any `WixSearchBuilder` functions,
 `find()` returns all matching site documents.



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## Perform a find on a search

```javascript
search.find()
  .then((results) => {
    if (results.documents.length > 0) {
      let documents = results.documents;
    } else {
      console.log("No matching results");
    }
  })
  .catch((error) => {
    console.log(error);
  });

```

## Create a search and run it

```javascript
import wixSearch from 'wix-search';

// ...

$w("#searchInput").onKeyPress((keyPress) => {
  if (keyPress.key === "Enter") {
    const phrase = $w("#searchInput").value;
    wixSearch.search(phrase)
      .find()
      .then((results) => {
        if (results.documents.length > 0) {
          let documents = results.documents;
        } else {
          console.log("No matching results");
        }
      })
      .catch((error) => {
        console.log(error);
      });
  }
});

```

## Create a search, add functions to the search, and run it

```javascript
import wixSearch from 'wix-search';

// ...

$w("#searchInput").onKeyPress((keyPress) => {
  if (keyPress.key === "Enter") {
    const phrase = $w("#searchInput").value;
    wixSearch.search(phrase)
      .documentType("Stores/Products")
      .eq("onSale", true)
      .ascending("sku")
      .limit(5)
      .find()
      .then((results) => {
        if (results.documents.length > 0) {
          let documents = results.documents;
        } else {
          console.log("No matching results");
        }
      })
      .catch((error) => {
        console.log(error);
      });
  }
});

```

## Build and run a search and display the results in a repeater

```javascript
import wixSearch from 'wix-search';

// ...

// Before search runs, set the repeater data as empty
$w('#repeater').data = [];

$w("#searchInput").onKeyPress((keyPress) => {
  if (keyPress.key === "Enter") {
    const phrase = $w("#searchInput").value;
    wixSearch.search(phrase)
      .documentType("Stores/Products")
      .find()
      .then((results) => {
        if (results.documents.length > 0) {
          $w('#repeater').data = results.documents;
        } else {
          console.log("No matching results");
        }
      })
      .catch((error) => {
        console.log(error);
      });
  }
});

$w("#repeater").onItemReady(($item, itemData) => {
  $item("#title").text = itemData.title;
  $item("#description").text = itemData.description;
  $item("#image").src = itemData.image;
  $item("#button").link = itemData.url;
});

```

---