> For the complete documentation index, see [llms.txt](https://docs.lawnchair.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lawnchair.app/core-features/search.md).

# Search

Lawnchair search helps you find apps, contacts, settings, files, and web results.

### Dock search bar

The *dock search bar* sits at the bottom of the home screen.

To change settings related to this feature, go to **Home settings** > **Search bar**, then tap the **Dock** tab.

<details>

<summary>Hide the search bar</summary>

1. Tap **Search bar widget**.
2. Select **Disabled**.

</details>

<details>

<summary>Change the search provider</summary>

A **search provider** is the service or app that opens when you tap the search bar.

1. Tap **Search provider**.
2. Choose your preferred provider from the list.
   * Some providers may require an app to be installed. Tap **Download** <i class="fa-arrow-down-to-line">:arrow-down-to-line:</i> to install it.
   * When choosing **Website**, Lawnchair will open the provider's search website in your default web browser.

</details>

<details>

<summary>Customize its appearance</summary>

You can adjust the search bar under the **Style** section.

* **Apply accent color**: Matches the search bar to the current theme.
* **Outline width**: Changes the border width. You can also set the border color when the value is not `0`.

</details>

### App drawer search bar

The *app drawer search bar* is built for searching both on-device content and the web.

To change settings related to this feature, go to **Home settings** > **Search bar**, then tap the **App drawer** tab near the top of the screen.

<details open>

<summary>What does <strong>Match dock search bar actions</strong> do?</summary>

This option links the behavior and appearance of both search bars:

* When turned on, the search bar will inherit the theme and icons of the dock search bar.
* Tapping the dock search bar will open the app drawer search UI instead of launching the selected search provider.

</details>

<details>

<summary>Choose the search algorithm</summary>

You can choose how Lawnchair finds results in the app drawer.

1. Tap **Search algorithm**.
2. Choose an option from the list:

* **App search**: Searches installed apps only.
* **Global search (on-device)**: Searches apps, contacts, files, settings, and other content stored on your device.

</details>

<details>

<summary>Choose local result types</summary>

If you choose **Global search (on-device)**, more options appear under **Show in search results**.

You can turn categories on or off. Some categories also include extra settings.

* **Apps and shortcuts**
  * Can still find results when you make small typing mistakes.
* **Web suggestions**
  * Lets you choose a built-in provider or a custom one.
  * If you use a custom provider, follow the URL instructions shown in settings.
* **People**
  * Searches contacts and related information.
* **Files**
  * Searches your device storage.
  * You can limit results to photos and videos, audio files, or all files.
  * In the Play Store version, **All files** access is not available because of Play Store restrictions.
* **Android settings**
  * Searches system settings.
* **Search history**
  * Shows recent queries when you tap the search bar.
* **Calculator**
  * Runs calculations directly in the search bar.

</details>

### Common issues

<details>

<summary>Search results are incomplete or not appearing</summary>

* Check your selected **Search algorithm**. Make sure it matches the type of results you want.
* If you use **Global search (on-device)**, make sure the right result types are turned on.
* Make sure Lawnchair has the permissions it needs.
* Check [Battery optimization](/troubleshooting/battery-optimization.md).

</details>

<details>

<summary>Web search or web suggestions are not working</summary>

* Check if you have a stable internet connection.
* Check if **Web suggestions** is turned on.
* Verify your selected **Web suggestions** provider.
  * If you use a custom provider, check that the URL is valid.

</details>

<details>

<summary>Tapping the home screen search bar opens the app drawer search instead of my selected provider</summary>

See [What does **Match dock search bar actions** do?](#what-does-match-dock-search-bar-actions-do).

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.lawnchair.app/core-features/search.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.