> ## Documentation Index
> Fetch the complete documentation index at: https://fal.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Searching and filtering

> Search your assets by description, image, or video, and narrow the results with library filters.

## Search with a description

Enter a description in the search bar. For example:

```text theme={null}
a green glass bottle on a pale sandy background
```

Text search finds media by meaning and similarity. It is not an exact phrase or filename lookup. Describe the subject, setting, composition, or appearance you remember.

## Search with an image or video

Choose **Search by image** or **Search by video** and select an example file. You can also drop an image or video onto the search field. The library finds visually related media within the current scope.

Use one search input at a time. Clear the active example to return to typing a description.

## Narrow the results

Search stays within the section or collection you have open. Use the available filters to narrow it further:

| Filter     | Example                                      |
| :--------- | :------------------------------------------- |
| Media type | Images or videos.                            |
| Source     | Uploads or generated outputs.                |
| Model      | Outputs from a particular endpoint.          |
| Tags       | Assets with any or all of the selected tags. |
| Collection | Search inside a campaign's collection.       |

For example, open **Summer campaign**, select **Images**, then search for `bottle on sand`. Clear the filters or return to **All media** if the scope is too narrow.

## Find characters and smart entities

In Agent, Sandbox, and supported model prompts, type `@` to open the entity picker. Search for a saved entity and select it as a reference.

The picker supports **characters, props, environments, styles, and scenes**. For example:

```text theme={null}
Create an image of @mara holding @green-bottle in @workshop.
Use @watercolor as the visual style.
```

You can combine several entity references in one prompt. Describe the role each entity plays in the result.

To browse an entity's associated media, open its page in Assets. See [Using entities in generations](/docs/documentation/assets/entities/using) for reference behavior and model requirements.

## Search freshness and large results

New generations and uploads can take time to become searchable. Browse recent media if an item is not yet returned by search.

If the library reports that a search scope is too large or results are incomplete, narrow it with a smaller collection or additional filters. See [FAQ and troubleshooting](/docs/documentation/assets/faq).

For a query you want to revisit, create a [smart collection](/docs/documentation/assets/organizing/smart-collections).