# Locked and private content

Source: https://frameleaf.app/docs/using/private-content/

**Locked** keeps sensitive photos and videos off your screen without moving them anywhere. A locked item stays in its albums, stacks, favourites and tags, and stays hidden everywhere until you unlock your session with your PIN.

It's perfect for anything you'd rather not have on screen during normal browsing: medical photos, prescriptions, card or bank images, identity documents, private family photos and personal records.

Locking is just a label. Your albums, stacks, favourites, tags, faces and timeline stay exactly as they are, and unlocking puts everything back where it was.

:::note
Locked keeps private photos out of sight in Frameleaf. Pair it with full-disk encryption, strong passwords and careful control of who can reach your server, and keep regular [backups](https://frameleaf.app/docs/admin/backup-and-restore/). If you use automatic detection, review its results.

To encrypt the files of your Locked items on the server's disk, turn on [Locked encryption](https://frameleaf.app/docs/using/locked-encryption/).
:::

## Set up your PIN

Locked uses a six-digit PIN. Create it in **Settings → Your sign-in & privacy → Locked PIN**. You can change or clear it there too.

Forgotten your PIN? Choose **Forgot your PIN?** and enter your account password to clear it. Your locked items stay locked. If password sign-in is turned off on your server, your administrator can clear it for you. While [Locked encryption](https://frameleaf.app/docs/using/locked-encryption/) is on, neither works: use your recovery key instead.

## Lock a photo

Lock a photo whichever way suits you:

- Select photos and choose **Lock** in the selection bar, or open a photo and choose **Lock** under **More actions**.
- Choose **Lock** while reviewing it in the **Info** panel.
- [Upload](https://frameleaf.app/docs/using/uploads-and-downloads/) straight into Locked.
- In the mobile apps, select photos you own and choose **Lock**.
- Lock a whole album with **Lock album…** in its menu. Your photos in it move to Locked, and anything you add later is locked too. See [Lock and unlock an album](https://frameleaf.app/docs/using/albums/#lock-and-unlock-an-album).

Locking is instant and needs no PIN, because it only hides things. Unlocking an item asks for your PIN.

Stacks and Live Photos lock as a whole. Locking one photo in a stack locks the whole stack, and the video part of a Live Photo locks with its photo.

### Why an item is locked

Every locked item has exactly one lock, which records why:

| Reason | How it got there |
| --- | --- |
| **Marked** | You locked it yourself, with Lock, a sensitive review, an upload into Locked, or an older app's "Move to Locked folder" |
| **Detected** | [Sensitive-content detection](#automatic-detection) flagged it while hiding is turned on |
| **Moved from old Locked folder** | It was in the old Locked folder when your library was upgraded to Frameleaf |

## Unlock your session

Select **Locked** in the top bar, near **Upload**, and enter your PIN.

- **Locked:** sensitive content is hidden.
- **Revealed:** this session can see it, and the arrow beside it opens the Locked view. Select **Revealed** to lock again. That hides it straight away and refreshes what's on screen.

Unlocking applies to the current session only, so signing out, or using another browser or app, asks for your PIN again.

Content hides when you leave this tab, and shows again when you come back, as long as you're still unlocked. Unlocking lasts an hour. Using Frameleaf in the last few minutes of that hour extends it by another hour, so your session locks itself after about an hour without activity.

## Who sees a locked item

| Who | What they see |
| --- | --- |
| You, while locked | Nothing. It's left out of the timeline, albums, search, the map, memories, people, pets and downloads. |
| You, after unlocking | Everything, as normal, plus the **Locked** view that lists every locked item. |
| Partners | Their own copy, which arrives locked. Only their own PIN opens it. See [Partners](#partners). |
| Album and space members | Never, whatever their own session. |
| Shared links | Never. |
| Administrators | Never, in the app. |
| Connected apps and AI assistants | Never, even while you're unlocked in your browser. They can't see a Locked album or add photos to one either. See [Connect AI assistants](https://frameleaf.app/docs/using/connect-ai-agents/#what-the-assistant-can-and-cant-do). |
| Server jobs | Always. Thumbnails, machine learning, backups and restorations still process locked items. |

Your own devices sync locked items marked as locked, so they stay hidden there too.

A [computer at home](https://frameleaf.app/docs/admin/workers/) that helps with everyone's photos never receives another account's Locked photos. It still works on the Locked photos of the account signed in on it.

A bulk change you start while locked skips any item that was locked after you started it.

## Revealed for this session

Once you unlock, every locked item, and everything your [Locked rules](#locked-rules) hide, works like any other item, everywhere, for you:

- **Search** finds them, including smart search, text in photos and Ask, and includes them in counts and suggestions.
- **Library views** show and count them: the timeline, archive, Explore, memories, people and pets, Best Photos, duplicates, albums, the map, tags and folders.
- **Actions** work on them: favourite, archive, add to album, change date or location, delete and download. **Studio** can place them in a project, use one as a project's poster and export them.

They're still yours alone. Sharing isn't offered for a revealed item, and it never becomes an album cover, a featured photo or a profile picture, because those are shown to everyone.

When you lock again, they keep every album, stack, tag, person, memory and Studio project they belong to, and disappear from view as before.

### Covers and featured photos

A locked photo is never an album, collection or space cover, a person's or pet's featured photo, a face thumbnail or a profile picture. Locking a photo releases every such use, and each falls back to another photo, Best Photos first, or to none.

### Memories

Memories are made from locked items too. While you're locked, any memory that contains a hidden item is hidden entirely: its title, date, cover, places and counts, everywhere memories appear, and its exports. So a title or place taken from a locked photo never gives anything away. Once you unlock, the memory shows normally with all its photos.

### Studio

While unlocked, you can use any of your locked items in a [Studio](https://frameleaf.app/docs/studio/overview/) project like any other. When you lock again:

- The project keeps them. The editor hides those clips entirely, rather than showing them as missing, and saving keeps them in the project.
- A poster taken from a locked item stays set, but the project shows a placeholder instead.
- An export made from a locked item is hidden, with its library item, its download and any share of it, until you unlock. Its library item takes the lock of its sources, and loses it once its last locked source is unlocked. An export you locked yourself stays locked.
- A project bundle you download while unlocked carries your revealed items' files if you include media, and is hidden while you're locked. Made while locked, it carries a locked item as a bare reference only.

## The Locked view

Open **Locked** after unlocking. It lists every locked item, newest first, together with the items your Locked rules hide, with a filter:

- **All** (the default), including Locked rule matches
- **Moved from old Locked folder**
- **Marked**
- **Detected**

Each tile is badged **Locked** (moved from the old folder) or **Sensitive** (marked, detected or matched by a rule).

Until you lock something, the page says **Nothing locked yet**: "Photos you lock show here, and only after you enter your PIN."

To unlock items, select them and choose **Unlock**. This also records them as reviewed and safe, so running detection again won't lock them again. You can still add locked items to albums, download them, change their date or location, or delete them permanently from here.

## Locked rules

Some content is private without being explicit, like medical photos, legal documents or a private project. **Locked rules** let you hide whole people, pets and tags from your own sessions in one go, until you unlock.

Set them in **Settings → Your sign-in & privacy → Always Locked**. The rules themselves stay hidden until you select **Unlock Locked settings** and enter your PIN. Make your changes, then select **Save Locked rules**.

- **Apply Locked rules to** either **My photos and videos** or **All photos and videos I can access**.
- A tag inside a locked tag is locked too, and the list says so.
- A tag, person or pet that no longer exists stays in your rules, marked unavailable, until you remove it. Saving another change never unlocks it.
- If your rules were changed in another tab or on another device since you opened them, your changes stay on screen. Reload the latest rules, then save.
- If your session locks before you save, your changes are dropped. Unlock again to carry on.

Items that match a rule appear under **All** in the Locked view. To bring them back, change your rules.

### Rules and what you've shared

A Locked rule also stops you sharing matching items one by one. A matching item can't be shared with a person, and someone you already shared it with stops seeing it, for as long as the rule applies.

What you've shared on purpose stays shared: an item in a shared album or space or a shared link stays visible there. To stop sharing it, remove it from the album or link, or lock the item itself. Partners work differently: a partner's copy of a matching item is locked in their library. See [Partners](#partners).

:::caution[Tag names are visible]
People you share an item with can see the tags on it, including a tag you use in a Locked rule. This includes album and space members, partners and shared links with **Show photo details** turned on. People's names work differently: album and space members see only the names they gave. A partner's copy brings your people's names, unless they already have that person.
:::

### Partners

If you share your library with a partner, they get their own copy of everything, Locked items included. See [Sharing](https://frameleaf.app/docs/using/sharing/#locked-items).

- A copy of a locked item arrives already locked in your partner's library. It's never visible there without their PIN, even for a moment.
- An item your Locked rules hide is copied locked too. Your rules stay yours and don't become theirs.
- Only your partner's own PIN opens their copy, like any of their own Locked items. Your PIN is never shared.
- While their copy follows yours, locking or unlocking your item later carries over to it. Once they change whether their copy is locked, it's up to them.
- If your partner has no PIN yet, their locked copies stay hidden and they see **A partner shared Locked items with you.** with **Set a PIN**.
- If you stop sharing, your partner keeps the copies they already have, locked ones included.

## Automatic detection

Let Frameleaf spot sensitive photos for you. Your administrator can turn on **Suggest photos to lock**, which checks photos on your server with a classifier. A detection locks a photo while **Hide flagged photos until unlocked** is also turned on. The classifier's result is kept privately, apart from visible tags.

Administrators can review each result, run detection again, mark a photo safe or NSFW, or accept the classifier's verdict.

For the smoothest start:

1. Run detection.
2. Review the results.
3. Turn on hiding. Any detections still unreviewed at that moment are locked.

## Upgrading from an older library

If your library had a Locked folder before it moved to Frameleaf, everything private stays private and nothing disappears:

1. Everything in the old Locked folder gets a lock with the reason **Moved from old Locked folder**, and goes back to its place in the timeline, hidden until you unlock.
2. Everything you'd locked yourself gets a **Marked** lock.
3. Items flagged by detection are locked only if **Hide flagged photos until unlocked** was on. With it off they were never hidden, so they stay where they are.
4. Stacks that were partly locked are locked as a whole, and the covers that locked photos held are replaced.

:::tip
Use Frameleaf over HTTPS. Frameleaf clears cached thumbnails when someone signs in or out using a browser feature that only works over HTTPS. On plain HTTP, a shared browser can keep showing the previous person's thumbnails for a while.
:::
