# Built-in smart albums

Source: https://frameleaf.app/docs/using/smart-albums/

Built-in smart albums sort your library for you. Once your administrator turns them on, Frameleaf fills six albums automatically, so your trips, receipts, screenshots, meals, pets and nature shots are always one click away:

| Album | What goes in |
| --- | --- |
| Travel | Airports, beaches, mountains and landmarks |
| Documents & Receipts | Letters, forms, receipts and whiteboards |
| Screenshots | Pictures of a phone or computer screen |
| Food | Meals, baking and restaurant tables |
| Pets | Cats, dogs and other animals at home |
| Nature | Forests, water, flowers and wildlife |

They fill from what is in each photo: the tags it gets from [AI descriptions](https://frameleaf.app/docs/using/ai-descriptions/), and what smart search sees in it. A photo can be in more than one. Each album holds only your own photos, and keeps filling as new ones arrive. In every other way they're ordinary albums: open, share and download them as you like.

You can also make your own smart albums from any search, or with **New**, then **Smart album**. Those follow a rule you build yourself; see [Albums](https://frameleaf.app/docs/using/albums/#smart-albums).

## Choose which ones you see

Your administrator chooses which albums are offered and how they fill. You choose which of them show in your library.

1. Open **Settings**, then **Your preferences**, then **Tools & sidebar**.
2. Under **Your smart albums**, each offered album shows a few of its photos and how many of yours it holds.
3. Turn an album's switch off to hide it. It shows as **Hidden**, and you can turn it back on at any time.

Hiding an album doesn't remove or change any photo, and it only affects your own library.

## Take a photo out

If a photo lands in the wrong album, such as a pet on the beach showing up in Travel, remove it from that album as you would from any other. Frameleaf remembers your choice and keeps it out for good, even when the albums are updated. Its other albums stay as they are.

## For administrators

Smart albums are off by default. Turn them on in **Settings**, then **Search & intelligence**, then **Categories & smart albums**, with **Build smart albums**. The page then lists the six albums, each marked **Offered** or **Not offered**, with how many photos it holds across your household.

For the best results, turn smart albums on once descriptions are working. Description tags feed the albums' tags, and the albums' descriptions are compared using visual search. See the [setup order](https://frameleaf.app/docs/using/ai-descriptions-setup/#setup-order).

### Settings for each album

Choose **Open** beside an album to change it:

| Setting | What it does | Default |
| --- | --- | --- |
| **Offer this album** | Off takes the album out of everyone's library. No photo is removed or changed. | On |
| **Album name** | The name everyone sees | Travel, Documents & Receipts, and so on |
| **Words that add a photo** | A photo joins when it shows any of these. A single word is a tag, which has to be on the photo exactly. Several words are a description, compared with what the photo looks like. | See the table below |
| **How strict** | **Fewer, surer** (almost every photo clearly belongs, and some that belong may be left out), **Balanced** (a few photos may not belong) or **More photos** | Balanced |

| Album | Single words (tags) | Descriptions |
| --- | --- | --- |
| Travel | airport, beach, mountain, landmark, hotel, passport, suitcase, tourist | vacation travel landscape; tourist destination |
| Documents & Receipts | receipt, document, invoice, paperwork, scan, id-card | paper document; receipt or invoice |
| Screenshots | screenshot, ui, screen-capture, user-interface | phone or computer screenshot |
| Food | food, meal, dish, restaurant, plate, cooking | plated food meal; restaurant dish |
| Pets | pet, dog, cat, puppy, kitten | domestic pet animal |
| Nature | nature, forest, mountain, ocean, sunset, wildlife, flower | natural landscape; wildlife |

**Advanced: the two lists and the number** shows what's behind those choices: **Tags that add a photo** and **Descriptions that add a photo**, one per line, and **Match strictness**, from 0.2 to 0.4, where higher adds fewer, closer matches. **How strict** sets it to 0.32, 0.28 or 0.24.

### See a change before you save

**Show what would change**, then **Show me**, compares your unsaved choices with your own library. It says how many photos would join and how many would leave, and shows some of each under **Would join** and **Would leave**. Nothing changes yet. If visual search doesn't answer, only the words are compared, and the page says so.

### Update the albums

New choices apply to photos added from then on. To sort the photos you already have again:

- **Update this album**, then **Update now**, on an album's page, sorts that album alone. Use it after changing one album's words.
- **Update albums now**, on the **Categories & smart albums** page, sorts every album.

Either one first shows how many described photos will be checked. Choose **Re-evaluate** to go ahead. Photos are added to or removed from albums as needed, and photos people took out stay out. If an update is already running, Frameleaf tells you instead of running it twice.

Updating uses the tags and search data you already have, so it's quick. If that data is missing, finish reading the library first.

### Ideas for words

A single word has to match a tag on the photo exactly, apart from capitals, so write it the way the tag is written: `golden-retriever` only matches a tag spelled with the hyphen.

| Album | Try adding |
| --- | --- |
| Travel | boarding pass, train station, hostel, market, temple, cathedral, and the cities and landmarks you photograph often, in lowercase |
| Documents & Receipts | prescription, manual, warranty, schedule, ticket-stub, identity-card, license |
| Screenshots | dashboard, browser, app-window, terminal, code |
| Food | Cuisines and dishes you photograph, such as sushi, pizza, ramen, latte-art or bbq |
| Pets | Your pets' breeds, such as golden-retriever or tabby, and other pets, such as rabbit or guinea-pig |
| Nature | waterfall, glacier, wildflower, autumn-foliage, milky-way, aurora |

### Categories of your own

The same settings page has two options for the categories and smart albums people build themselves:

| Setting | What it does | Default |
| --- | --- | --- |
| **Suggest my own categories** | Lets people describe a category, such as "birthday parties", and see which photos match before anything is tagged | On |
| **When a photo matches a category** | **Ask me first**: matches wait in a list to accept, and nothing is tagged until then. **Tag it automatically**: matching photos get the category's tag straight away. | Ask me first |

Nothing is ever archived unless someone chooses that for a category.

## Troubleshooting

### A photo never appears in an album

Check, in order:

1. Smart albums are on, the album is offered, and you haven't hidden it under **Your smart albums**.
2. The photo's description has finished.
3. Its tags, in **Info**, include one of the album's single words. If you rely on descriptions instead, check visual search is on and try **More photos** under **How strict**.
4. Nobody took the photo out of that album.

### An album has photos that don't belong

For one photo, remove it from the album. For a pattern, take the offending word out of **Words that add a photo**, or choose **Fewer, surer**, then **Update this album**.
