Skip to content

Account settings

Your account settings: preferences, devices and API keys Watch on YouTube

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.

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
Import & export Google Photos import, Export a copy and What Cloud Backup keeps. See Preservation packages
Library care Health checks, repair tools and identical-file savings. See 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
Change history Every preference you’ve saved, with when and the values

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 name, photo and the email you sign in with.

  • 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 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 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.

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

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.
  • 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.
  • 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.
  • 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.
  • 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.

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
Memories On On Photos from this day in past years. Nothing is shared unless you share it. See Memories
People On On Browse photos by who is in them. See 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
Shared links On On Make links to share photos with people outside this server. See Shared links
Tags On On Organise photos with your own labels. See 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
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.
  • People options → Include archived photos (off): shows archived photos on person pages and counts them in People. See 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.

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.

What you get when you download photos. Changes wait for the Save bar. See Download.

  • 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.

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

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.

Choose whether AI work on your photos and videos, such as finding faces, preparing search and writing descriptions, may use Frameleaf Cloud. 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.

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 photos never go to it. See Computers.

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.

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.

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.

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.

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, 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. An administrator’s password reset removes your passkeys too.

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.

Create, change or clear the six-digit PIN that protects your Locked 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.

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.

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.

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

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.

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. Home Assistant shows here too when it signs in through Frameleaf. See Connected apps and Connect AI assistants.

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.

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. 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 and, for administrators, Email.

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.