# Account settings

Source: https://frameleaf.app/docs/using/account-settings/

Make Frameleaf work the way you like. Your account settings cover your profile, password, Locked PIN, the features you want to see, downloads, devices and API keys, and they only ever affect your own account.

To open your settings, select your avatar in the top-right corner and choose **Account Settings**, or open **Settings** from the sidebar. Settings opens on **Your preferences**. Use the search box at the top to jump to any setting by name.

:::note
If you're an administrator, the same Settings screen also holds the server's settings. This page covers only what every account has. For the server side, see [The Command Center](https://frameleaf.app/docs/admin/command-center/).
:::

## Where things are

| Area | What's in it |
| --- | --- |
| **Your preferences** | Your profile, Look & playback, Tools & sidebar, Downloads, Where your photos are processed, Frameleaf account, Your library in numbers and Supporter |
| **Your sign-in & privacy** | Password, Passkeys, Two-step sign-in, Locked PIN, sign-in provider, Always Locked, signed-in devices, Account activity, connected apps and API keys |
| **Notifications** | Emails you receive |
| **People & sharing** | Partners & recipient groups, and **Suggest matching people in shared Spaces**. See [Sharing](https://frameleaf.app/docs/using/sharing/) |
| **Import & export** | Google Photos import, Export a copy and What Cloud Backup keeps. See [Preservation packages](https://frameleaf.app/docs/using/preservation/) |
| **Library care** | Health checks, repair tools and identical-file savings. See [Library Care](https://frameleaf.app/docs/using/library-care/) |
| **Tools** | Duplicate review, Large files, Fix locations, Live Photo pairing, iCloud Photos, Workflows and Mobile apps |
| **Trash** | Your deleted items. See [Trash and large files](https://frameleaf.app/docs/using/trash/) |
| **Change history** | Every preference you've saved, with when and the values |

## Your preferences

Your preferences opens on a short list of its pages. **Everyday** holds the pages you change most, **Your account** the ones about the account itself, and **Kept somewhere else** points to **Emails you receive** in Notifications and to the password, PIN and signed-in devices in Your sign-in & privacy. These settings are only for you: other people on this server choose their own.

Most pages save with a Save bar at the bottom. Look & playback is the exception: most of it is kept on this device and applies as you choose it.

### Your profile

Your name, photo and the email you sign in with.

#### Photo

- **Profile photo** is shown beside your name to other people on this server. **Upload a photo** or, once you have one, **Change photo** and **Remove photo**. Choose a JPEG, PNG, WebP, HEIC, AVIF, DNG or SVG image. If a photo can't be used, your current avatar is unchanged. A [Locked](https://frameleaf.app/docs/using/private-content/) photo is never used as a profile picture.
- **Colour without a photo** is the colour of the circle with your initial. It's used when you have no photo, or if you remove the one you have. Pick from Frameleaf green, pink, red, yellow, blue, green, purple, orange, grey and amber. It saves as you pick it.

#### Name and email

- **Name** is how your name appears to other people on this server.
- **Email** is used to sign in and for emails from this server.

**Save** writes both; **Undo changes** puts the saved values back. **Details for support** stays closed at the bottom and holds two things a helper may ask for:

- **Account ID** is a code that names your account. It is not a password. **Copy** puts it on the clipboard.
- **Your folder on the server** is where your original files are kept, inside this server's photo storage. It reads **Chosen by the server** unless your administrator has named a folder for you.

### Look & playback

Theme, language, how dates and times appear, and how photos and videos play.

#### Appearance

Most of these are kept on this device, and your other devices keep their own choices. **Date format** and **Time format** belong to your account, so every browser you sign in to shows dates and times the same way.

- **Light or dark**: **Match this device** (the default) follows this device as it changes through the day; **Light** and **Dark** stay put. The moon button at the top of the app changes this too.
- **Language** is the language of the web app on this device, and of the notifications and emails your account gets. Each language is listed under its own name: English, Français, Español, Deutsch, Italiano, Português, Nederlands, Polski, Svenska, Dansk and Norsk bokmål. Every screen, email and notification is translated into each of them. If you never choose one, your account takes the language the app is shown in the first time it opens in a language other than English; until then your emails are in English. A few things stay in English: the wording of emails your administrator writes, anything people typed, product names such as Frameleaf and Studio, and the gallery emails a studio sends to its clients.
- **Dates and numbers**: **Match this device** (the default) formats dates, times and numbers the way this device does. **Choose a region** shows a **Region** list to format them for another language and region. The page shows what today looks like in your choice.
- **Date format** chooses how dates are written: **Automatic** (the default) follows your region, or pick **2026-11-01**, **01/11/2026** (day first) or **11/01/2026** (month first). You keep your language either way.
- **Time format** chooses the clock: **Automatic** (the default) follows your region, **12-hour (2:30 PM)** or **24-hour (14:30)**.
- **Use less movement** (off) uses fewer animations. If this device asks for less movement, Frameleaf always follows it.

#### Browsing

- **Open the library in** is the view you start in: **Timeline**, **Browse** or **Work**. Until you choose, it shows the layout you used last on this device. You can switch at any time. See [Three layouts](https://frameleaf.app/docs/using/library/#three-layouts).
- **Show albums**: **Newest first** (the default) or **Oldest first**. It only changes how albums look for you, on every device you use. This one is an account preference and waits for the Save bar.
- **Show file names in Work view** (off) puts each file's name under its picture.
- **Show archived photos in search** (off) lets archived photos appear in search results. It's an account preference and waits for the Save bar. Use Locked to keep something private; see [Private content](https://frameleaf.app/docs/using/private-content/).

#### Photos and videos

- **Show full-quality photos** (off) shows the original in the viewer rather than a preview. Sharper, but slower to load and uses more data.
- **Play a video when the pointer rests on it** (on) plays a short preview in the library, without opening the video.
- **Start videos by themselves** (off) plays a video as soon as you open it.
- **Repeat videos** (off) starts a video again when it reaches the end.
- **Play the original video file** (off) plays the original instead of the lighter copy made for playback. Some originals may not play in this browser.

#### Safety

- **Ask before deleting forever** (on) shows a warning before a photo or video is removed for good.
- **Let uploads bring back deleted photos** (off) restores a photo from your trash when you upload the same file again, for 24 hours, then turns itself off. See [Bring photos back by uploading them](https://frameleaf.app/docs/using/trash/#bring-photos-back-by-uploading-them).

### Tools & sidebar

Choose which tools you use and which appear in the sidebar. When a tool is off, its sidebar item goes too. Turning a tool off hides it; nothing is deleted, and your data stays fully available. Turning off shared links leaves your existing links working. Changes wait for the Save bar.

**Your tools** is a table with a **Use** switch and a **Show in sidebar** switch per tool. A sidebar switch keeps its value and is only held while its tool is off.

| Tool | Use | Show in sidebar | What you get |
| --- | --- | --- | --- |
| **Folders** | On | On | Browse photos by the folders they came from. See [Folders](https://frameleaf.app/docs/using/library/#folders) |
| **Memories** | On | On | Photos from this day in past years. Nothing is shared unless you share it. See [Memories](https://frameleaf.app/docs/using/memories/) |
| **People** | On | On | Browse photos by who is in them. See [People](https://frameleaf.app/docs/using/people/) |
| **Pets** | Always on | On | See your pets' photos together. Turn **Show in sidebar** off if you don't keep pets; you can still open Pets from Explore. See [Pets](https://frameleaf.app/docs/using/people/#pets) |
| **Shared links** | On | On | Make links to share photos with people outside this server. See [Shared links](https://frameleaf.app/docs/using/sharing/#shared-links) |
| **Tags** | On | On | Organise photos with your own labels. See [Tags](https://frameleaf.app/docs/using/tags/) |
| **Star ratings** | On | Not a sidebar item | Give photos one to five stars |
| **Cast to a TV** | Off | Not a sidebar item | Show photos and videos on a TV with Chromecast. See [Casting to a TV](https://frameleaf.app/docs/using/casting/) |
| **Recently added** | Always on | On | Keep your newest photos one click away |

Two tools keep options under their row, closed, while the tool is on:

- **Memories options** → **Each photo stays for**: how long a photo is on screen while a memory plays. **3 seconds**, **5 seconds** (the default) or **8 seconds**. See [Memory settings](https://frameleaf.app/docs/using/memories/#memory-settings).
- **People options** → **Include archived photos** (off): shows archived photos on person pages and counts them in People. See [Archived photos in People](https://frameleaf.app/docs/using/people/#archived-photos-in-people).
- **People options** → **Show a person once they appear in**: **1 photo**, **3 photos** (the default), **5 photos** or **10 photos**. People in fewer photos stay out of the People page until then. This is only for your own view.

A number saved from another app or the API that isn't one of the choices shows as **Custom** and is kept until you pick another.

:::note
If your administrator has turned casting off for your account, the **Cast to a TV** row says **Your administrator has turned casting off for your account.** and its switch is held. Allowing it again restores your own choice.
:::

**Your sidebar**, beside the table, shows what the switches make: the items that are always there in grey (Photos, Explore, Map, Favorites, Albums and Trash) and the tools you've added between them.

### Downloads

What you get when you download photos. Changes wait for the Save bar. See [Download](https://frameleaf.app/docs/using/uploads-and-downloads/#download).

#### What a download contains

- **Include the short video with Live Photos and motion photos** (off): downloads get the moving part as well as the still.
- **Add a details file beside each photo** (on): a small file with the date, place and tags. The photo itself is not changed. See [Sidecar files](https://frameleaf.app/docs/using/uploads-and-downloads/#sidecar-files).

There is no original-or-edited choice: each photo downloads as it is shown, the version being viewed.

#### Big downloads

Large downloads arrive as several zip files, so one interrupted file does not cost you the rest.

- **Split big downloads into files of**: **2 GB**, **4 GB (recommended)**, which is the default, **10 GB** or **Custom**. Custom shows a **File size** field in GB, from 1 to 100. The page says how many files a 25 GB album would arrive as.

A size set from another app that isn't one of the three shows as **Custom** and is kept exactly until you change it.

### Where your photos are processed

Choose whether AI work on your photos and videos, such as finding faces, preparing search and writing descriptions, may use [Frameleaf Cloud](https://frameleaf.app/docs/cloud/cloud-gpu/). Each person on the server chooses for their own photos.

[![Where your photos are processed: a choice between At home or on Frameleaf Cloud and Only at home, then Where your photos go explaining shared photos, who can change this, search text and work already started.](https://frameleaf.app/shots/docs/photos-processed-2026-11.jpg)](https://frameleaf.app/shots/docs/photos-processed-2026-11.jpg)

Under **Your photos and videos**, pick one:

| Choice | What it means |
| --- | --- |
| **At home or on Frameleaf Cloud** (the default) | Follows the choices your administrator made in **Computers**. Work set to run on Frameleaf Cloud may use your photos. Frameleaf Cloud is used only where the administrator chose it, and each paid job shows its cost first |
| **Only at home** | This server and computers at home only. Your photos are never sent to Frameleaf Cloud for AI work. Work set to run on Frameleaf Cloud runs on this server or a computer at home for your photos instead. Other people's photos aren't affected |

The page also answers the questions people ask most:

- **What you type in search** is **Read at home**. Search text is never sent to Frameleaf Cloud, whatever you choose.
- **Photos you share** **Keep your choice**. A photo in a shared album, or seen by a partner, follows its owner's choice, whoever looks at it.
- **Work already started** **Finishes where it is**. Changing this affects new work only. Nothing is read again.
- **Who can change this**: **Only you**. The administrator sees your choice in **Computers** but can't change it.

A computer at home counts as home. When your administrator lets a home computer work on everyone's photos, under **Whose photos each computer works on** in **Computers**, it also does the photos of people who chose **Only at home**. Another account's [Locked](https://frameleaf.app/docs/using/private-content/) photos never go to it. See [Computers](https://frameleaf.app/docs/admin/workers/).

### Frameleaf account

Link your own Frameleaf account so you can sign in when you are away from home. **Link Frameleaf account** sends you to frameleaf.cloud and back; your local password, albums and photos stay as they are. Once linked, the page says which email it's linked to and since when, and **Unlink** removes it. Unlinked, you can't reach this server from outside your home until you link again; signing in at home is unchanged.

The page says **Your administrator has not linked this server to Frameleaf yet** until the server is [linked to Frameleaf Cloud](https://frameleaf.app/docs/cloud/account/#link-a-server).

### Your library in numbers

How much is in your library, and how much room it takes. The headline counts your photos and videos and says how much room they use, of your limit if your administrator set one.

- **Room on this server** appears when you have a limit, with a **Room used** meter. At 90 percent full the page warns you: when it is full, new photos cannot be added until you make room, and **Open the Trash** is the quickest way.
- **Inside that total** counts **Favorites**, **Archived**, **In the Trash** and **Albums** (with how many are shared). Favourites and archived items are part of your photos and videos. Items in the Trash still take room until it is emptied.
- **When you added photos** and **When your photos were taken** are two year grids. Each square is a day; darker means more. Older photos you added this year count on the day they were taken.

### Supporter

Whether you support Frameleaf, and your own supporter key.

- Without a key: an Individual licence is a one-time purchase for your account on any server. It adds a supporter badge, lets Cloud Backup include your library with a Frameleaf Cloud plan, and lowers plan prices. **Already have a key?** takes a personal key, which looks like FL-IXXX-XXXX-XXXX; **Activate** applies it. A server key can't be activated here: an administrator activates it under Frameleaf Cloud → Licence.
- With your own key: the page shows the key's last characters and when it was activated. **Hide the supporter badge** (off) keeps supporting without showing the badge next to your name. **Remove** takes the key off your account; it stays yours to activate again.
- If this server's Server licence covers everyone here, you do not need your own.

**Open Support Frameleaf** opens the purchase page. See [Licences, plans and credit](https://frameleaf.app/docs/cloud/account/#licences-plans-and-credit).

## Your sign-in & privacy

### Password

This page is called **How you sign in** and lists every way into your account, including your passkeys.

Enter your current password, then the new one twice. Passwords are at least 8 characters. **Sign out my other devices** is on by default; the device you're using stays signed in. Changing your password also ends **Trust this browser** on every browser.

If you've forgotten your password, ask your administrator to reset it.

### Passkeys

A passkey lets you sign in with your face, your fingerprint or your phone's screen lock instead of typing your password. It lives on your device or in your password manager, and Frameleaf only keeps a key that can check it. Your password keeps working alongside it.

Open **Passkeys** in Your sign-in & privacy, or the **Passkeys** row on **How you sign in**:

1. Select **Add a passkey…** and enter your password to show it's you. It isn't asked again for 10 minutes.
2. **Follow your browser's steps**: choose where to save the passkey (this device, your phone or a password manager) and confirm with your face, fingerprint, PIN or screen lock. Choose **Cancel** in the browser's window to stop; nothing is saved.
3. **Name your passkey**, such as "Work laptop", and select **Save**.

**Your passkeys** lists each one with where it's saved, when it was added and when it was last used. **Rename** changes its name; **Remove** stops it signing you in straight away. After removing it, you can also delete it from your device or password manager so it isn't offered any more.

To sign in, choose **Sign in with a passkey** on the sign-in page. A passkey sign-in skips your password and the [two-step code](https://frameleaf.app/docs/using/two-step-sign-in/), and it's accepted away from home too.

- **Passkeys need a secure address**, one that starts with `https`. On a plain `http` address, such as one on your home network, the sign-in page says so where the button would be, with a link to the secure address when there is one; otherwise sign in with your password. If Sign in with Frameleaf is offered there, **Use your Frameleaf passkey** signs you in with the passkey on your Frameleaf account.
- **Each passkey works only at the address you added it on.** To sign in with one away from home, add another while you're using remote access.
- **Lost a device?** Remove its passkey here from another device. If you can't sign in at all, your administrator can remove all your passkeys; see [Users](https://frameleaf.app/docs/admin/users/#passkeys). An administrator's password reset removes your passkeys too.

### Two-step sign-in

Ask for a 6-digit code from the authenticator app on your phone after your password. **Turn on…** sets it up and gives you 10 recovery codes for when you can't use your phone. Once it's on, **Your two-step sign-in** has **Move to a new phone…**, **Make new codes…** and **Browsers you trust**. See [Two-step sign-in](https://frameleaf.app/docs/using/two-step-sign-in/).

### Locked PIN

Create, change or clear the six-digit PIN that protects your [Locked](https://frameleaf.app/docs/using/private-content/) photos and videos. You enter it to unlock your session.

Forgotten it? Choose **Forgot your PIN?** and enter your account password to clear it. Your locked photos stay locked. If your server has password sign-in turned off, your administrator can clear your PIN for you.

### Sign-in provider

If your server uses a sign-in provider, such as your own identity service, connect or disconnect your account here. If your administrator has set up the provider's account page, you can open it from here too.

### Always Locked

Choose which tags, people and pets stay Locked, and whether the rules cover **My photos and videos** or **All photos and videos I can access**. The rules are hidden until you unlock with your PIN, and can only be changed while you're unlocked. See [Locked rules](https://frameleaf.app/docs/using/private-content/#locked-rules).

### Signed-in devices

See everywhere your account is signed in. Sign out one device, or every device except the one you're using.

### Account activity

Every sign-in to your account, each change to your password, PIN, passkeys and two-step sign-in, what you shared and what your connected apps did, newest first, with the device and whether it was at home or away. The row says when you last signed in, or warns you when sign-ins didn't work in the last day. **This wasn't me** on a line tells you what to do about it. Activity is kept for 400 days. See [Account activity](https://frameleaf.app/docs/using/account-activity/).

### Connected apps

AI assistants and other apps you've allowed into your library. Each one only does what you allowed, and none can open your Locked photos. Choose **Remove** to stop one straight away. **Connect an AI assistant** shows your library's assistant address and the steps for Claude, ChatGPT or an assistant on your computer; see [Connect AI assistants](https://frameleaf.app/docs/using/connect-ai-agents/). [Home Assistant](https://frameleaf.app/docs/using/home-assistant/) shows here too when it signs in through Frameleaf. See [Connected apps](https://frameleaf.app/docs/admin/connected-apps/) and [Connect AI assistants](https://frameleaf.app/docs/using/connect-ai-agents/).

### API keys

API keys let other apps and scripts, such as the command-line tool, use your account.

- **Create** a key with only the permissions an app needs, or with full access.
- **Edit** a key's name and permissions.
- **Rotate** a key to get a new value. The old value stops working straight away.
- **Delete** a key you no longer use.

A new or rotated key is shown only once, so copy it somewhere safe.

## Notifications

**Emails you receive** chooses which emails Frameleaf sends you. Everything here always shows in the bell at the top of the app; email is extra.

- **Send me emails** (on) sends them to the email on your profile; **Change address** opens Your profile. Turning this off also stops the emails below.
- **Tell me about** lists each kind. Album updates and invites appear in the bell; new sign-in alerts are sent by email. **When someone shares with you** (on), for albums and photos shared with you, and **Album updates** (on), for new photos in an album shared with you, can also be emailed. **Sign-ins from unfamiliar devices or networks** (on) emails you when someone signs in to your library from a device or network this server doesn't recognise; see [New sign-in emails](https://frameleaf.app/docs/using/notifications/#new-sign-in-emails). **Mentions and replies** in shared Spaces and **Invitations to share face recognition** are app only.

If the server can't send email yet, the page says so and keeps your choices until an administrator sets it up. See [Notifications](https://frameleaf.app/docs/using/notifications/) and, for administrators, [Email](https://frameleaf.app/docs/admin/email/).

## Saving changes

Change as many settings as you like, then save. If you changed your settings in another tab or on another device in the meantime, Frameleaf keeps your changes on screen and asks you to load the latest values before saving, so your work in both places is safe.

**Change history** lists every preference you've saved, with when it was saved and the old and new values.
