> For the complete documentation index, see [llms.txt](https://docs.albumfiler.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.albumfiler.com/shortcuts/find-album.md).

# Find Album

Find user-created albums in Photos.

{% hint style="warning" %}
AlbumFiler currently does not retrieve user-generated smart albums.
{% endhint %}

<table><thead><tr><th width="314">Parameters</th><th>Description</th></tr></thead><tbody><tr><td>Albums</td><td>If provided, the action will search through the items pass as input (optional). Otherwise, the action will search through all albums.</td></tr><tr><td>Filter</td><td>Album name, path, is favorite, and is recent.</td></tr><tr><td>Sort by</td><td>Album name or album path</td></tr><tr><td>Limit</td><td>Limit the number of items returned.</td></tr></tbody></table>

| Returns | Description                        |
| ------- | ---------------------------------- |
| Albums  | The items that match the criteria. |