> 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/tree/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