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

# The search overlay

There's a search bar at the top of every page on Kumbaya. Click it (or press **`/`** on your keyboard) and a search overlay opens — it's the fastest way to jump to any token or pool on the platform.

![The Kumbaya search overlay in default state, showing curated bluechip tokens and top pools](/files/r3LEqhTzFrEiLxOb0hAp)

## What it covers

The overlay searches across **everything Kumbaya tracks on-chain**:

* **Tokens** — both curated (bluechip, verified) and any token launched on the Kumbaya launchpad.
* **Pools** — every Uniswap V3 pool indexed on Kumbaya, with fee tier and TVL.

It's powered by Kumbaya's [search service](https://github.com/Kumbaya-xyz/documentation/blob/main/developer/apis/search-service.md), so results are fast and update as new tokens and pools land on-chain.

## How to use it

### Open it

* Click the **search bar** in the top header, or
* Press **`/`** on your keyboard.

### Type to search

Start typing a token symbol, name, or even a partial contract address. Matches surface as you type — no need to press Enter.

![Typing a query — results filter live with fuzzy substring matching across symbol, name, and address](/files/p6XBjnLi56mLjbgWU4Jk)

The search is fuzzy and substring-aware: typing `eth` will match "Ether", "Wrapped Ether", "ETH BURN", "ETHERBUTTS", and so on. Each row shows the token's icon, symbol, name, partial address, and current price + 24h change.

### Filter by what you're looking for

Two layers of filtering:

**Tab — Kumbaya Tokens / All Tokens**

* **Kumbaya Tokens** — curated and verified tokens (the default). Best for general use.
* **All Tokens** — every indexed token, including unverified ones. Use when you're looking for something specific that isn't on the curated list.

**Chips — All / Bluechip / Memecoins / Pools / ⚙**

* **All** — tokens and pools mixed, default view.
* **Bluechip** — only blue-chip tokens (ETH, USDC, etc.).
* **Memecoins** — community tokens launched on the Kumbaya launchpad.
* **Pools** — only pools, useful when you're looking for liquidity opportunities.
* **⚙ (cog)** — opens **Manage**, where you can control which token lists are active and add or remove manually-imported tokens. See [**Managing token lists**](#managing-token-lists) below.

### Select a result

Click any token to go to its detail page (`kumbaya.xyz/#/launch/<address>` for launchpad tokens, or the swap page pre-filled with that token). Click any pool to go to the pool detail page.

### Close it

* Press **Esc**.
* Click outside the overlay.

## What appears by default

When you open the overlay without typing, you'll see two curated lists:

* **Bluechip** — the most recognizable tokens on Kumbaya (ETH, MegaUSD, WETH, USDT0, etc.).
* **Pools** — top Uniswap V3 pools by TVL.

This is meant as a quick-jump for the most common destinations.

## Managing token lists

Click the **⚙ cog** in the search overlay to open **Manage**. It has two tabs:

**Lists**

* Every token list connected to your Kumbaya session — Kumbaya's default list plus any you've imported.
* Toggle each list on or off. Tokens from disabled lists won't appear in your search results.
* Add a new list by pasting its URL (any standard [Uniswap-format token list](https://tokenlists.org/) works).
* Remove lists you've imported.

**Tokens**

* Tokens you've manually imported by contract address (separate from any list).
* Search/paste a contract address to import a single token without adding a whole list.
* Remove a manually-imported token to clear it from your search results.

This is the right place to go if a token isn't showing up in search but you have its contract address, or if you want a curated list provider's tokens to appear alongside Kumbaya's defaults.

## Tips

* **Pasting an address works.** If you paste a `0x…` token or pool address into the search box, the matching token or pool surfaces directly. Useful for verifying an address you got from elsewhere.
* **Search launchpad tokens by ticker.** Launchpad tokens are tagged in the search results so you can tell them apart from pre-existing tokens.
* **Use `/` first thing.** It's the fastest navigation shortcut on the platform — works from any page.

## Where to next

* [**Discovering tokens →**](/launchpad/discover.md) — the launchpad feed view
* [**Swapping tokens →**](/trading/swap.md) — once you've found one


---

# 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.kumbaya.xyz/getting-started/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.