Skip to content

armgit / ente

Public Imported from GitHub
0

💚 End-to-end encrypted cloud for everything.

[docs] Clarify FAQs for Auth, Photos, and Locker (#13694)

Shanthy281086bafea7
diff --git a/docs/docs/auth/faq/index.md b/docs/docs/auth/faq/index.md
index 495ac7c350..84c783d6f1 100644
--- a/docs/docs/auth/faq/index.md
+++ b/docs/docs/auth/faq/index.md
@@ -58,6 +58,18 @@ When you sign in, your device uses your password to unlock the master key locall
If you choose **Use without backups**, your codes stay on that device and are not synced to Ente. Make an [encrypted export or local backup](/auth/migration/export) before changing devices or resetting it.
+### Do I need my Ente recovery key or a website's backup codes? {#recovery-key-or-backup-codes}
+
+Use the recovery method for the account you are trying to access:
+
+- **Ente recovery key:** The 24-word phrase for your Ente account. If you use the same Ente account in Photos, Auth, and Locker, the recovery key is the same across those apps. Separate Ente accounts have separate recovery keys.
+- **A website's backup or recovery codes:** Codes provided by that website when you set up its two-factor authentication. Ente Auth generates authenticator codes from the setup key you saved; it does not generate the website's separate backup-code list.
+- **Email verification code:** A temporary code sent to your email during a sign-in or verification step. It does not replace your Ente recovery key or another website's backup codes.
+
+If you cannot sign in to another service, use that service's recovery options or contact its support team. If you cannot sign in to Ente, see [account recovery](/photos/faq/security-and-privacy#account-recovery) and [lost second-factor help](/photos/faq/security-and-privacy#two-factor-auth).
+
+Keep your recovery materials somewhere you can reach without signing in to the account they protect. See [Enteception](/auth/faq/enteception/) if you store the second factor for Ente or your email account inside Ente Auth.
+
### How can I delete or edit codes?
You can delete or edit a code by long pressing (or right clicking on desktop) on that item.
@@ -74,6 +86,14 @@ You can enable FaceID lock under Settings → Security → Lockscreen.
Auth's lock screen acts as a barrier to prevent an attacker from accessing the contents of the app. It does not introduce a layer of cryptographic security.
+### Why is Ente Auth blank in Android screenshots or screen mirroring? {#android-screen-capture}
+
+Check **Hide content** on your phone under `Settings > Security > App lock`. When enabled on Android, it blocks screen capture, which can also make Auth appear blank in screen recordings or mirroring tools.
+
+If you need to capture the screen, you can turn **Hide content** off on the phone. Doing so can expose your codes to screenshots, recordings, or anyone viewing the mirrored screen. Only turn it off if you accept that risk, and turn it back on afterwards. Ente support cannot change this setting remotely.
+
+**Hide codes** is a separate display option. Learn more in the [App lock guide](/auth/features/#app-lock).
+
### Why do the desktop and mobile apps display different codes?
Please verify that the time on both your mobile and desktop is the same.
@@ -96,19 +116,21 @@ That said, many users are able to use Ente Auth with Google Workspace without is
Also ensure that your system time is accurate, as any time drift can cause TOTP codes to be invalid. You can verify your time at https://time.is/
-### Can I access my codes on web?
+### Can I access my codes on web? {#can-i-access-my-codes-on-web}
-You can access your codes on the web at [auth.ente.com](https://auth.ente.com).
+You can access the codes synced to your Ente account at [auth.ente.com](https://auth.ente.com).
### Why doesn't auth.ente.com recognize my email when I try to log in? {#auth-web-email-not-recognized}
-If the web app says no account exists for your email, even though you're logged in on the mobile or desktop app, it's usually a stale cached email from a previous attempt. Try the following in order:
+First check the email shown in the settings of a working Ente app. If you changed your account email, use the new address. For a self-hosted account, also check that you are using the correct server.
-1. On the login screen, click **Change email address** and re-enter your current email.
-2. Clear your browser's site data for `auth.ente.com` (or the cache for that domain).
-3. Open the page in an incognito or private window.
+If the same account works in an app or another browser, try these browser-specific checks:
-If you recently changed the email on your Ente account, make sure you're entering the new address, not the old one.
+1. On the login screen, choose **Change email address** and re-enter the account email.
+2. Try [auth.ente.com](https://auth.ente.com) in a private or incognito window. Keep any working session in the original window or another app.
+3. If the private window works but the normal window still fails, clear site data for `auth.ente.com` in the affected browser and try again. This removes that site's saved browser session, so first make sure you can sign in again and have preserved any working access elsewhere.
+
+These checks can also help when only one browser rejects the password. They do not establish that cached site data is the cause of every sign-in failure. If the problem remains, see [verification troubleshooting](#sync-password-recovery-failures).
### Why don't I see my codes after logging in? {#auth-codes-not-showing}
@@ -124,8 +146,34 @@ If your codes were created offline and you've since lost access to that device,
No, Ente Auth does not require an account. You can choose to use the app without backups if you prefer.
+### Can I merge two Ente accounts or move my Auth codes to another account? {#merge-accounts}
+
+Separate Ente accounts cannot be merged. Changing an account's email address does not combine it with another account.
+
+You can move Auth codes by exporting and importing them:
+
+1. In the source account, create an [encrypted export](/auth/migration/export#create-encrypted-export). Save the file outside the app and keep the export password safe.
+2. Keep the source app signed in. On another trusted device or installation, sign in to Auth with the Ente account you want to keep. Check the account email before importing.
+3. Open `Settings > Data > Import codes`, choose **Ente Encrypted export**, select the file, and enter the password you chose for the export.
+4. Compare the imported entries with the source. Verify that the codes work for the services you need, and that the destination account has synced and is accessible on your other devices.
+5. Keep the source and encrypted backup until these checks are complete. If you cannot keep a working copy while switching accounts, contact [[email protected]](mailto:[email protected]) before signing out or removing data.
+
+This moves Auth codes only. Photos libraries, subscriptions, account history, and Locker data do not merge through this process.
+
+> [!WARNING]
+>
+> **Delete account** deletes that account's Photos, Auth, and Locker data. Do not use it just to stop using Auth or to free an email address before checking what is stored in the account. See [shared-account deletion](/photos/faq/security-and-privacy#shared-account-deletion).
+
### How can I delete my account? {#auth-delete-account}
+> [!IMPORTANT]
+>
+> Deleting a code from Ente Auth, uninstalling Auth, or deleting your Ente account does **not** disable two-factor authentication at the websites or services that use those codes. They will continue asking for their second factor.
+>
+> Before removing your codes, create an [encrypted export](/auth/migration/export) and verify that you can import it, or verify that another authenticator or recovery method works for each service. Keep a working copy until you have checked access to every account you need.
+>
+> If you have already lost the codes, use each service's backup codes, account-recovery process, or support team. Ente cannot disable another service's MFA or recover that service's account for you.
+
You can delete your account at any time by using the "Delete account" option in the settings. For security reasons, we request you to delete your account on your own instead of contacting support to ask them to delete your account.
Note that Ente Photos, Ente Auth, and Ente Locker data will be deleted when you delete your account (irrespective of which app you delete it from) since Photos, Auth, and Locker use the same underlying account.
@@ -175,6 +223,12 @@ The HTML export generates individual QR codes for each of your codes, making it
Due to E2EE, the server doesn't know anything about your codes. Everything is encrypted, including the tags, type, account, issuer, notes, pinned or trash status, etc.
+### Why did only some of my codes import? {#partial-import}
+
+An import may skip entries it cannot read. Check that you selected the [correct import option for the exported file](/auth/migration/import#choose-import-format), then compare the imported entries with your original authenticator and [verify the codes](/auth/migration/import#verify-import).
+
+Keep the original authenticator and export until all the entries you need are present and working. Switching to **Plain text** does not fix every provider-format problem. If entries are still missing, contact [[email protected]](mailto:[email protected]) with the app versions, export type, and entry counts. Do not send secret-bearing exports or QR codes.
+
### Why do some Google Authenticator codes fail to import? {#google-authenticator-import-failed}
Google Authenticator exports some codes in a format that other authenticator apps may not be able to read correctly. This can happen especially with Google account entries.
@@ -213,12 +267,16 @@ If the option to change the PIN doesn't appear, log out by tapping the back arro
### Codes won't sync, password is rejected, or recovery key keeps failing. Where do I start? {#sync-password-recovery-failures}
-Most of these failures come from network-level filtering between your device and our servers. Common causes:
+A generic verification error can have several causes, including a request timing out while contacting the server. The message alone does not establish that your password is wrong, an email code was missed, your account is locked, or your device is short of memory.
+
+Keep any working app or browser session signed in while you troubleshoot. Before resetting your account or reinstalling the app:
+
+1. Try another trusted connection, such as switching between Wi-Fi and mobile data.
+2. If only one browser fails, follow the [browser checks](#auth-web-email-not-recognized).
+3. If you are entering a recovery key, check its [format and word order](/photos/faq/security-and-privacy#use-recovery-key).
-- DNS-level blockers like NextDNS, AdGuard, or Pi-hole filtering one of `*.ente.io`, `*.ente.com`, or `*.backblazeb2.com`.
-- A custom Private DNS server on your phone.
-- A VPN routing traffic in a way that interferes with Ente endpoints.
+Network filtering can interfere with sign-in and sync. Check whether a DNS blocker, custom Private DNS configuration, or VPN is blocking Ente endpoints such as `*.ente.io`, `*.ente.com`, or `*.backblazeb2.com`. Review its settings or temporarily test without it, then restore your usual protection. On a managed network, ask the administrator for help.
-If you use any of these, allowlist Ente's domains or temporarily disable the blocker and try again. After clearing the interference, signing in and syncing should work normally.
+If a password reset failed partway through, the new password may already have been saved even though the app did not receive confirmation. Try signing in with the new password before repeating the reset.
-If you were in the middle of resetting your password using your recovery key and the app showed an error partway through (for example, after multiple network drops), your new password may have already been registered on our server even though the app didn't get the success confirmation. Before retrying the reset flow, try signing in with the new password directly.
+If the problem continues, contact [[email protected]](mailto:[email protected]) with the exact error text, Auth version, operating system, and whether another device or connection works. Never include your password, recovery key, or authenticator codes.
diff --git a/docs/docs/auth/faq/installing.md b/docs/docs/auth/faq/installing.md
index 2142e770f4..f82c5f3d3d 100644
--- a/docs/docs/auth/faq/installing.md
+++ b/docs/docs/auth/faq/installing.md
@@ -48,9 +48,11 @@ Alternatively, you can follow these steps:
<br/>
-# iOS
+# iOS {#ios}
-You can install Ente Auth on Apple devices from [AppStore](https://apps.apple.com/us/app/ente-auth/id6444121398).
+You can install Ente Auth on iPhone and iPad from the [App Store](https://apps.apple.com/us/app/ente-auth/id6444121398).
+
+The iOS app can also run on compatible Apple-silicon Macs. For the native macOS app, including Intel Macs, use the [desktop download](#desktop).
<br/>
@@ -62,6 +64,10 @@ You can install Ente Auth on Apple devices from [AppStore](https://apps.apple.co
You can grab the latest version of Ente Auth for Mac, Windows and Linux from [GitHub](https://github.com/ente/ente/releases?q=tag%3Aauth-v4).
+On macOS, download the `.dmg` file for the native desktop app. This is a separate build from the iOS app offered through the App Store on Apple-silicon Macs. Use the native desktop build if you need Intel Mac support or are having trouble entering an app-lock PIN with your Mac keyboard.
+
+Before switching builds, confirm that your codes have synced to your account and are accessible on another device, or create and verify an [encrypted export](/auth/migration/export). Keep the existing app and its data until your codes work in the new installation.
+
On Linux, App lock can use system authentication in releases newer than `auth-v4.4.22`. Learn how to [set up Linux system authentication](/auth/troubleshooting/linux-system-auth).
<br/>
@@ -88,6 +94,8 @@ Latest versions of our web app are available at [auth.ente.com](https://auth.ent
The Ente Auth desktop app requires Windows 10 or later. Windows 7 and 8 are not supported.
+If Auth cannot start and Windows reports that `MSVCP140.dll` is missing, see the [Visual C++ runtime troubleshooting steps](/auth/troubleshooting/windows#missing-msvcp140-dll).
+
---
# CLI
diff --git a/docs/docs/auth/features/index.md b/docs/docs/auth/features/index.md
index 002388a8b7..2da3d710e7 100644
--- a/docs/docs/auth/features/index.md
+++ b/docs/docs/auth/features/index.md
@@ -122,6 +122,8 @@ Additionally, configure **Auto lock** to automatically lock the app after a spec
App lock protects access to the app UI. It is not a recovery password for your codes and does not re-encrypt the stored Auth data.
+On Android, **Hide content** under `Settings > Security > App lock` blocks screen capture and hides app previews. This can make screenshots, recordings, or screen mirroring appear blank. Turning it off allows capture and can expose your codes, so only do so knowingly and turn it back on when finished. This is separate from **Hide codes**, which hides individual code values in the app.
+
### Import / Export
![Import codes provider list on Ente Auth mobile](https://docs-assets.ente.com/screenshots/auth-import-hub.png){width=320px}
diff --git a/docs/docs/auth/migration/export.md b/docs/docs/auth/migration/export.md
index ffa12f32f9..e084de23cb 100644
--- a/docs/docs/auth/migration/export.md
+++ b/docs/docs/auth/migration/export.md
@@ -5,11 +5,23 @@ description: Guide for exporting your 2FA codes out from Ente Auth
# Exporting your data out of Ente Auth
+## How do I create an encrypted export? {#create-encrypted-export}
+
+1. Open `Settings > Data > Export` in Ente Auth.
+2. Select **Encrypted**.
+3. Choose a strong password for this export. This is the export-encryption password you will need when importing the file; it is not automatically your Ente account password.
+4. Complete any device-authentication prompt and save the exported file in a private location outside the app. Keep a copy somewhere you can access after a device reset or change.
+5. Keep the export password safe. Ente cannot recover it for you. Before relying on the backup or removing the original codes, verify that you can import the file on another trusted installation and that the entries you need are present and work.
+
+Keep a working copy of your codes while testing an export. Do not send the export, its password, or the underlying setup keys to support.
+
## Auth Encrypted Export format
-### Overview
+### Overview {#overview}
+
+An encrypted Auth export uses a key derived from the password you choose when creating that export. Importing the file requires that export password. Changing your Ente account password does not change the password of an existing export.
-When we export the auth codes, the data is encrypted using a key derived from the user's password. This document describes the JSON structure used to organize exported data, including versioning and key derivation parameters.
+The following sections describe the JSON structure, versioning, and key derivation parameters of the encrypted export.
### Export JSON Sample
@@ -51,9 +63,9 @@ This section contains the parameters that were using during KDF operation:
- `opsLimit`: Operations limit for the algorithm.
- `salt`: The salt used in the derivation process.
-##### Encrypted Data
+##### Encrypted Data {#encrypted-data}
-As mentioned above, the auth data is encrypted using a key that's derived by using user provided password & kdf params. For encryption, we are using `XChaCha20-Poly1305` algorithm.
+The Auth data is encrypted with `XChaCha20-Poly1305`. The encryption key is derived from the export password and the key derivation parameters stored in the file.
## Automated backups
diff --git a/docs/docs/auth/migration/import.md b/docs/docs/auth/migration/import.md
index 705ef66fbc..6cd4b97a39 100644
--- a/docs/docs/auth/migration/import.md
+++ b/docs/docs/auth/migration/import.md
@@ -29,6 +29,18 @@ To import from OTP Auth, export an encrypted backup in OTP Auth. In Ente Auth's
>
> Please note that this list may be out of sync, please see the app for the latest set of supported providers.
+## Which import option should I choose? {#choose-import-format}
+
+Choose the option that matches the file you exported and the formats supported by your installed Auth version:
+
+- For an export from a listed provider, follow that provider's instructions in **Import codes**.
+- For an encrypted Ente export, choose **Ente Encrypted export** and enter the password chosen when that export was created.
+- For a supported plain text file containing `otpauth://` entries, choose **Plain text**.
+
+A filename or the name of the source app alone does not establish the format. Native 2FAS exports, for example, can differ between versions, and choosing **Plain text** is not a general workaround for a failed 2FAS import.
+
+Keep the original authenticator and export until you have [checked the imported entries](#verify-import). Do not upload secret-bearing exports to online converters or public issue trackers.
+
Ente Auth also supports imports from Auth's own encrypted exports and plain text files. Plain text files must be in the following format:
`otpauth://totp/provider.com:[email protected]?secret=YOUR_SECRET`
@@ -36,3 +48,14 @@ Ente Auth also supports imports from Auth's own encrypted exports and plain text
The codes can be separated by a comma or a new line.
So if your provider is not specifically listed, you might be still able to import from them by first converting the data from your old provider into these plaintext files and then importing those into Ente.
+
+## How do I check that every code imported? {#verify-import}
+
+1. Compare the imported entries with the source authenticator, including the expected number of accounts and their names. Check for missing entries and duplicates.
+2. Verify that the imported codes work for the services you need. A successful import message or an entry count does not by itself verify the codes.
+3. If you use an Ente account, let the import sync and check that the entries appear on another signed-in device.
+4. Keep the old authenticator and a safe copy of the export until you have completed these checks.
+
+If the import fails or only some entries appear, contact [[email protected]](mailto:[email protected]) with the source app and version, your Auth version and operating system, the export type, and the expected and imported entry counts. Support can help identify the appropriate format or version-specific steps.
+
+Do not include the export file, setup keys, QR codes, or current authenticator codes in your message. Exports can contain the secrets needed to generate codes, so keep them private.
diff --git a/docs/docs/auth/troubleshooting/windows.md b/docs/docs/auth/troubleshooting/windows.md
index 76f3c6efc3..24905727f3 100644
--- a/docs/docs/auth/troubleshooting/windows.md
+++ b/docs/docs/auth/troubleshooting/windows.md
@@ -5,6 +5,18 @@ description: Troubleshoot Windows Hello and login errors in Ente Auth
# Windows Troubleshooting
+## Ente Auth cannot start because MSVCP140.dll is missing {#missing-msvcp140-dll}
+
+This error indicates that a Microsoft Visual C++ runtime dependency needed by the app is missing or unavailable.
+
+1. Open Microsoft's [supported Visual C++ Redistributable downloads](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170).
+2. Install or repair the supported Redistributable that matches the architecture of the Ente Auth build you installed. The package must match the app's architecture, which may differ from the operating system's architecture.
+3. Follow the installer's instructions, restart Windows if requested, and try opening Ente Auth again.
+
+On a shared or managed computer, ask your administrator to install or repair the runtime. Do not download individual DLL files from third-party sites, and do not delete Auth's data to address this error.
+
+If you are unsure which package is needed or the error remains, contact [[email protected]](mailto:[email protected]) with your Windows version, Auth version, and the exact error message.
+
## Windows Hello Prompt Does Not Appear
Ente Auth uses Windows Hello when an action requires system authentication.
diff --git a/docs/docs/locker/faq/getting-started.md b/docs/docs/locker/faq/getting-started.md
index 97fde55a00..6c52ad3327 100644
--- a/docs/docs/locker/faq/getting-started.md
+++ b/docs/docs/locker/faq/getting-started.md
@@ -44,6 +44,8 @@ Uploaded files are saved as separate Locker items. You can group them in a colle
The Locker mobile app's **File** option is for selecting files.
+Uploading the same files again can create separate items. Locker does not currently detect duplicate uploads; see [how to handle duplicate files](/locker/faq/organization#locker-duplicate-uploads).
+
## Account
### How do I create a new Ente account? {#locker-create-account}
diff --git a/docs/docs/locker/faq/organization.md b/docs/docs/locker/faq/organization.md
index d8f21557bd..5dd2cc38cb 100644
--- a/docs/docs/locker/faq/organization.md
+++ b/docs/docs/locker/faq/organization.md
@@ -62,6 +62,16 @@ To add an item to additional collections:
4. Select the new collection
5. Tap **Save**
+## Duplicate uploads {#duplicate-uploads}
+
+### Does Locker detect duplicate files? {#locker-duplicate-uploads}
+
+No. Locker does not currently detect duplicate uploads. Uploading a file again can create another copy, including when you upload a folder more than once.
+
+Before removing a duplicate, open the copy you intend to keep and check that it is complete. Keep a backup outside Locker if you are unsure. If you move unwanted copies to Trash, do not permanently delete them while you are still checking your files. Restore anything you need before the [Trash retention period](#locker-trash-retention) ends.
+
+If one upload creates multiple copies, [contact support](/locker/faq/troubleshooting#locker-contact-support) so we can investigate. Include the Locker version, device and OS, what you uploaded, and [debug logs](/locker/faq/troubleshooting#locker-share-logs). Duplicates alone do not establish that you uploaded the file more than once.
+
## Trash
### How long do deleted items stay in Trash? {#locker-trash-retention}
diff --git a/docs/docs/locker/faq/security.md b/docs/docs/locker/faq/security.md
index 242202c1b0..46355701c5 100644
--- a/docs/docs/locker/faq/security.md
+++ b/docs/docs/locker/faq/security.md
@@ -111,22 +111,23 @@ To know details of how your data is deleted, including when you delete your acco
### What happens if biometric authentication fails? {#locker-biometric-fail}
-After multiple failed attempts:
+If you use **Device lock**, your device may offer its passcode when biometric authentication fails. Follow the authentication options shown by your device.
-- Your device may require its passcode instead
-- If PIN is configured in Locker, you can use that as fallback
-- The app remains locked until successful authentication
+A custom Locker PIN or password is a separate app-lock method. It is not a fallback that remains enabled alongside Device lock. Locker stays locked until you authenticate successfully.
### Can I change my PIN? {#locker-change-pin}
-Yes. Open `Settings > Security > Lock screen > Change PIN` and follow the prompts.
+Yes. Open `Settings > Security > App lock`, authenticate when prompted, and select **Pin lock** to set and confirm a new PIN.
+
+Your device must have a passcode or screen lock configured before you can open the App lock settings.
### Is lock screen available on all devices? {#locker-lock-screen-availability}
-Lock screen is available on all iOS and Android devices. The specific biometric options depend on your device capabilities:
+App lock is available in Locker's iOS and Android apps. First configure a passcode or screen lock in your device's system settings, then open `Settings > Security > App lock` in Locker.
+
+You can choose **Device lock**, **Pin lock**, or **Password**. Device lock uses the authentication methods supported by your device, such as Face ID, Touch ID, fingerprint, or its passcode.
-- **iOS**: Face ID, Touch ID
-- **Android**: Fingerprint, face unlock (device dependent)
+See the [Lock screen guide](/locker/features/security/lock-screen) for setup and auto-lock options.
## Related Features
diff --git a/docs/docs/locker/faq/troubleshooting.md b/docs/docs/locker/faq/troubleshooting.md
index 64a006cb84..260e148be6 100644
--- a/docs/docs/locker/faq/troubleshooting.md
+++ b/docs/docs/locker/faq/troubleshooting.md
@@ -60,6 +60,21 @@ Try searching for the item's title or name. Use descriptive titles to make items
4. **Check 2FA**: If enabled, enter your 2FA code correctly
5. **Try another device**: Test if you can log in elsewhere
+### I'm signed in, but uploads fail with an invalid-session error. What should I do? {#locker-invalid-session-uploads}
+
+If Locker or support identifies an invalid-session or invalid-token error during uploads, signing out and back in may refresh the session. Check the following before signing out:
+
+1. Preserve any files or newly created items that have not finished syncing in a safe location outside Locker, and check that those copies can be opened
+2. Verify which items are already available from your account on another device or on [Locker web](https://locker.ente.com)
+3. Make sure you can sign in again with the correct account, password, and any required two-factor authentication. Keep your recovery key safely available
+4. [Export debug logs](#locker-share-logs) if support needs them to investigate the failure
+
+> [!WARNING]
+>
+> Signing out clears Locker's local offline copies. Do not sign out, reinstall the app, or clear its data if you cannot verify that all unsynced items are safely preserved outside Locker. [Contact support](#locker-contact-support) first.
+
+Once these checks are complete, sign out of Locker and sign back in to the same account, then retry an upload. If it still fails, contact support with the error and logs. Other upload problems may have a different cause.
+
### I'm locked out and don't have my recovery key {#locker-locked-out}
Without your recovery key and password, your account cannot be recovered unless you previously set up [Legacy recovery](/locker/features/legacy/). This is an intentional security feature of end-to-end encryption.
@@ -68,19 +83,23 @@ To prevent this in the future, always save your recovery key in multiple secure
### 2FA is not accepting my code {#locker-2fa-issues}
-1. **Check time sync**: Ensure your device's time is accurate
-2. **Use correct app**: Use the authenticator app where you set up 2FA
-3. **Try backup codes**: Use a backup code if available
-4. **Wait for new code**: TOTP codes change every 30 seconds
+1. **Check time sync:** Ensure your device's date and time are accurate, preferably using automatic time settings.
+2. **Use the correct entry:** Open the authenticator where you set up two-factor authentication for this Ente account. A code for another website or another Ente account will not work.
+3. **Wait for a new code:** Try the next code before it expires.
+4. **Use your Ente recovery key:** If you cannot access your second factor, use the recovery option shown during sign-in and the 24-word recovery key for this Ente account. Backup codes from another website cannot recover Ente access.
+
+If you have lost both the second factor and recovery key but still know your password, see [lost second-factor help](/photos/faq/security-and-privacy#two-factor-auth). Keep any working session signed in. Never send your password, recovery key, or authenticator codes to support.
## Lock Screen Issues
### Lock screen isn't working {#locker-lock-screen-not-working}
-1. Check that lock screen is enabled in `Settings > Security`
-2. Verify your device has biometric authentication configured
-3. Try setting up a PIN as an alternative
-4. Restart the app
+1. Make sure a passcode or screen lock is enabled in your phone's system settings
+2. Open `Settings > Security > App lock` in Locker and authenticate when prompted
+3. Turn on **App lock** and choose **Device lock**, **Pin lock**, or **Password**
+4. If you use Device lock, check your device's authentication settings
+
+See the [Lock screen guide](/locker/features/security/lock-screen) for setup details. If setup still fails, [contact support](#locker-contact-support) with your device model, OS version, and Locker version.
### I forgot my Locker PIN {#locker-forgot-pin}
@@ -113,11 +132,11 @@ Include:
### How do I share debug logs with support? {#locker-share-logs}
-1. Open `Settings > Support`
+1. Open `Settings > Help & Support` in the Locker mobile app
2. Tap **Export logs**
-3. Share the exported file with [[email protected]](mailto:[email protected])
+3. Send the exported file privately to [[email protected]](mailto:[email protected]), along with a description of the problem
-Logs help us diagnose issues but contain no personal data.
+Logs help us diagnose issues. Review the exported file before sharing it, and avoid posting logs publicly.
## Connectivity
diff --git a/docs/docs/locker/features/security/lock-screen.md b/docs/docs/locker/features/security/lock-screen.md
index 91e03006f5..90577a2569 100644
--- a/docs/docs/locker/features/security/lock-screen.md
+++ b/docs/docs/locker/features/security/lock-screen.md
@@ -1,26 +1,33 @@
---
title: Lock Screen
-description: Add an extra layer of security with Face ID, Touch ID, fingerprint, or PIN protection
+description: Protect the Locker mobile app with device authentication, a PIN, or a password
---
# Lock Screen
-Lock screen adds an extra layer of protection to your Locker app. Even if someone has access to your unlocked phone, they can't open Locker without authenticating.
+App lock adds an extra layer of protection to the Locker mobile app. When Locker is locked, you must authenticate before opening its contents.
+
+## Before you start {#before-you-start}
+
+Set up a passcode or screen lock in your phone's system settings before configuring Locker's app lock. This is required even if you want to use a custom PIN or password in Locker. Keep your device screen lock enabled.
## Available authentication methods
-### Biometric
+Choose one app-lock method at a time:
-Use your device's biometric authentication:
+### Device lock {#biometric}
-- **Face ID** (iOS)
-- **Touch ID** (iOS)
-- **Fingerprint** (Android)
-- **Face unlock** (Android, device dependent)
+Use your device's authentication, such as Face ID, Touch ID, fingerprint, or its passcode. The available methods depend on your device and system settings.
### PIN
-Set a numeric PIN code as an alternative or backup to biometric authentication.
+Choose **Pin lock** to set a custom numeric PIN for Locker.
+
+### Password {#password}
+
+Choose **Password** to set a custom password for Locker's app lock.
+
+Device lock, PIN, and password are alternatives. A custom Locker PIN is not an additional fallback that stays enabled alongside Device lock.
## Enabling lock screen
@@ -31,66 +38,42 @@ Set a numeric PIN code as an alternative or backup to biometric authentication.
![Security settings with App lock on Ente Locker mobile](https://docs-assets.ente.com/screenshots/locker-lock-screen.png){width=320px}
1. Open Ente Locker
-2. Open `Settings > Security`
-3. Tap **Lock screen**
-4. Choose your authentication method:
- - **Biometric**: Uses your device's biometric settings
- - **PIN**: Set a numeric PIN
-5. Confirm your choice
+2. Open `Settings > Security > App lock`
+3. Authenticate when prompted
+4. Turn on **App lock**
+5. Choose **Device lock**, **Pin lock**, or **Password**, and follow the prompts
+
+If Locker says that no system lock was found, configure a passcode or screen lock in your phone's settings, then try again.
## Configuring lock screen
### Auto-lock timing
-Set when Locker automatically locks:
+Open `Settings > Security > App lock > Auto lock` to choose how soon Locker locks after it is put in the background.
-1. Open `Settings > Security`
-2. Tap **Auto-lock**
-3. Choose a timing option:
- - **Immediately**: Locks when you leave the app
- - **After 1 minute**: Locks after 1 minute of inactivity
- - **After 5 minutes**: Locks after 5 minutes of inactivity
- - **Never**: Only locks when you manually lock or restart the app
+Available intervals are **Immediately**, **5s**, **15s**, **1m**, **5m**, and **30m**.
-### Lock on app switch
+### Hide content {#hide-content}
-Lock Locker whenever you switch to another app:
-
-1. Open `Settings > Security`
-2. Enable **Lock on app switch**
+Open `Settings > Security > App lock` and turn on **Hide content** to hide Locker's contents in the app switcher. On Android, this also disables screenshots of the app.
## Using lock screen
### Unlocking
-When Locker is locked:
-
-1. Open the app
-2. Authenticate with your chosen method (biometric or PIN)
-3. The app unlocks and shows your content
-
-### Manual locking
-
-Lock Locker manually without closing the app:
-
-1. Open `Settings > Security`
-2. Tap **Lock now**
-
-Or close and reopen the app (if auto-lock is set to "Immediately").
+When Locker is locked, open it and authenticate with the method you selected. If you chose Device lock, the authentication options are provided by your device.
## Fallback options
-If biometric authentication fails:
+With **Device lock**, your device may offer its passcode if biometric authentication fails. Follow the options shown by your device.
-1. Most devices allow multiple attempts
-2. After several failures, you may need to use your device passcode
-3. If PIN is enabled as backup, you can use that instead
+If you chose a custom Locker PIN or password, use that method to unlock Locker. These methods are separate from Device lock.
## Security considerations
-- Lock screen protection only works when your device is unlocked
-- For maximum security, also secure your device with a strong passcode
-- Biometric data is handled by your device, not Ente
+- Keep your phone protected with a strong device passcode or screen lock
+- Remember the custom PIN or password you choose for Locker
+- Biometric authentication is handled by your device
## Related FAQs
diff --git a/docs/docs/photos/faq/account-creation.md b/docs/docs/photos/faq/account-creation.md
index 22f9f655d5..a4a94c7d05 100644
--- a/docs/docs/photos/faq/account-creation.md
+++ b/docs/docs/photos/faq/account-creation.md
@@ -75,6 +75,10 @@ Alternatively, you can follow these manual steps:
**Desktop app:** You'll get an in-app notification to update. Ente desktop includes auto-update functionality - whenever updates are deployed, the app will automatically download and install them.
+Update the app on each device that needs it, using its existing distribution channel first. If uploads report that the upload API is no longer supported, follow the [specific troubleshooting steps](/photos/faq/troubleshooting#unsupported-upload-api).
+
+On Android, changing distribution channels may install a separate app and require signing in and setting up backup again. See [Android installation](/photos/getting-started/installation#android) before switching.
+
### Why is my language not an option in Ente? {#language-not-available}
Ente relies on community translations through Crowdin. A language is usually added to the apps once about 90% of it has been translated. New languages also need approval from Ente before they appear.
@@ -134,6 +138,14 @@ No. Use the same account across all your devices. Your photos, albums, and all y
Only use separate accounts if you want to keep photo libraries completely separate (for example, personal vs. work photos).
+### Can I merge separate Ente accounts? {#merge-accounts}
+
+No. Changing an account's email address does not merge it with another account. Photos libraries, subscriptions, and account history remain separate.
+
+If you want to use your Photos account for Auth too, you can [export and import your Auth codes](/auth/faq/#merge-accounts). Verify the imported codes and sync before removing any source data.
+
+Before deleting an old account, check what it contains in Photos, Auth, and Locker. **Delete account** removes that account's data across all three apps. See [shared-account deletion](/photos/faq/security-and-privacy#shared-account-deletion).
+
## Account Creation & Security
### How do I create a new Ente account? {#create-account}
@@ -257,3 +269,5 @@ Check whether you may have signed up using:
- Apple Sign-In or another provider-linked email
If you have a paid account, also check how the payment was made. App Store and Stripe payments can help identify which account was used.
+
+An App Store purchase may already be linked to a different Ente account. Making another purchase does not transfer that subscription or its storage to the account you are currently using. If the purchase appears on the wrong account, contact [[email protected]](mailto:[email protected]) so we can check the association before you buy again.
diff --git a/docs/docs/photos/faq/albums-and-organization.md b/docs/docs/photos/faq/albums-and-organization.md
index a46c2941ee..2ad4f9e5f3 100644
--- a/docs/docs/photos/faq/albums-and-organization.md
+++ b/docs/docs/photos/faq/albums-and-organization.md
@@ -159,6 +159,8 @@ Photos appear in Uncategorized when:
- You delete an album but choose to keep the photos
- You delete a file from a [watched folder](/photos/faq/backup-and-sync#watch-folders) on desktop
+You cannot choose Uncategorized as the destination for mobile automatic backup. Selected device folders back up to corresponding Ente albums. See [how mobile backup maps to albums](/photos/faq/backup-and-sync#automatic-backup).
+
Learn more in the [Uncategorized feature guide](/photos/features/albums-and-organization/uncategorized).
### Why are photos appearing in Uncategorized? {#why-uncategorized}
@@ -187,19 +189,23 @@ Alternatively, if you have the original photos on your device, you can delete th
### How do I clean up Uncategorized items? {#clean-uncategorized}
-**On mobile:**
+To remove entries that are also in another album you own:
+
+- **On mobile:** Open Uncategorized, tap the three-dot menu, and select **Clean Uncategorized**
+- **On desktop:** Open Uncategorized and select the clean icon (broom)
+
+Items that exist only in Uncategorized remain there.
-1. Open the Uncategorized album
-2. Tap the three dots (overflow menu)
-3. Select "Clean Uncategorized"
+To organize those remaining items on desktop:
-This will automatically remove all files from Uncategorized that are also present in another album that you own. Only files exclusive to Uncategorized will remain.
+1. Select the photos in Uncategorized and choose **Move** in the action bar
+2. Choose the first destination album
+3. Open that album and select the photos again
+4. Choose **Add to album** for each additional destination, one at a time
-**Manual cleanup:** You can also manually:
+On mobile, **Add to album** lets you select multiple destination albums. Adding a photo to another album does not require uploading the original again and does not use extra photo storage.
-- Add photos from Uncategorized to specific albums
-- Delete photos you don't need from Uncategorized
-- Move photos to appropriate albums by selecting them and choosing "Add to album"
+See [organizing Uncategorized photos](/photos/features/albums-and-organization/uncategorized#organize-uncategorized-photos) for details.
### Can I delete the Uncategorized album? {#delete-uncategorized}
diff --git a/docs/docs/photos/faq/backup-and-sync.md b/docs/docs/photos/faq/backup-and-sync.md
index 7c9366c025..127bee6633 100644
--- a/docs/docs/photos/faq/backup-and-sync.md
+++ b/docs/docs/photos/faq/backup-and-sync.md
@@ -11,6 +11,8 @@ description: Frequently asked questions about backing up and syncing photos in E
Once you select which albums to backup in your mobile app settings, Ente automatically syncs new photos and videos from those albums to the cloud. Backup happens in the background without needing to open the app.
+Each selected device folder or album backs up to a corresponding Ente album. Mobile automatic backup does not offer **Uncategorized** as a destination. You can browse local folders under **Albums > Device** and backed-up Ente albums under **Albums > Ente**.
+
**Key features:**
- Background sync runs automatically
@@ -32,6 +34,8 @@ Open `Settings > Backup > Backed up folders` and select the albums you want to a
Once configured, new photos added to these albums will automatically sync in the background.
+The chooser lists device folders and albums; it is separate from your Ente album list. The count on a folder tile is the total reported for that device folder, not the number waiting to upload. If **Backup only new photos** is enabled, its cutoff still applies even when the tile shows older photos in its total.
+
### Does hiding a folder stop Ente Photos from backing it up? {#hidden-folder-backup}
No. Hiding a folder does not change its backup setting. To stop new photos in that folder from backing up:
@@ -61,6 +65,8 @@ Yes. You can enable this during signup/login on the permissions screen, or later
In both cases, photos older than the cutoff will not be uploaded to Ente.
+The totals shown in **Backed up folders** still include older items in each device folder. Those totals do not mean older items are eligible for automatic upload. Use [Backup status](#check-backup-status) to check pending uploads.
+
To resume backing up your full library, toggle the setting off.
Learn more in the [Backup only new photos](/photos/features/backup-and-sync/#backup-only-new-photos) guide.
diff --git a/docs/docs/photos/faq/gallery-mode.md b/docs/docs/photos/faq/gallery-mode.md
index 554cff6a11..ab447c1cfa 100644
--- a/docs/docs/photos/faq/gallery-mode.md
+++ b/docs/docs/photos/faq/gallery-mode.md
@@ -65,6 +65,12 @@ There are three places to sign up:
No. All your device photos remain on your device, and any ML processing (face recognition, search embeddings) done in gallery mode is preserved. Signing up adds cloud features on top of your existing local experience.
+### Will signed-in machine learning include photos I have not backed up? {#signed-in-indexing-scope}
+
+While signed in, face recognition and Magic search index photos backed up to Ente. Local photos that have not been backed up are not automatically included, even if you can see them in the device gallery.
+
+Gallery Mode provides local-photo indexing in the mobile app while signed out. There is currently no combined mode that indexes both an Ente library and unbacked local photos while signed in. See [which photos are indexed](/photos/features/search-and-discovery/machine-learning#which-photos-are-indexed).
+
### Can I go back to gallery mode after signing up? {#return-to-offline}
Once you sign in to an Ente account, the app operates in signed-in mode. To return to gallery mode, you would need to sign out.
diff --git a/docs/docs/photos/faq/metadata-and-editing.md b/docs/docs/photos/faq/metadata-and-editing.md
index 107bb8ca8f..73c2a09b4f 100644
--- a/docs/docs/photos/faq/metadata-and-editing.md
+++ b/docs/docs/photos/faq/metadata-and-editing.md
@@ -66,7 +66,11 @@ This shows all the technical data about the photo including camera settings, len
Anyone you share an album with sees the same item details you do: capture date, camera EXIF, captions, album titles, and map pins, because that metadata decrypts together with the photo.
-Public link viewers see the same fields. Contributor emails on a shared album are masked on public links by default; see [Why do emails on my feed appear masked for public links?](https://ente.com/help/photos/faq/sharing-and-collaboration#masked-emails-public-links).
+Public link viewers see the same fields. Contributor emails on a shared album are masked on public links by default; see [Why do emails on my feed appear masked for public links?](/photos/faq/sharing-and-collaboration#masked-emails-public-links).
+
+There is no public-link setting to hide location data. Editing a location in Ente does not remove GPS coordinates embedded in the original file or change the copy in your phone's photo library. Turning off downloads does not remove that metadata either.
+
+To share without GPS metadata, create separate copies outside Ente with location metadata removed, then verify those copies before uploading and sharing them. Keep your original files privately, and keep them out of the album containing the sanitized copies.
## Importing from Google Photos
@@ -80,16 +84,20 @@ For example, `flower.jpeg` might be in one zip and `flower.json` in another. Thi
### Why are my Google Photos dates wrong after import? {#google-photos-dates-wrong}
-If the dates appear incorrect after importing from Google Takeout, it's usually because:
+A date can be incorrect if Ente could not match a photo to its Google Takeout JSON sidecar, or if the available metadata contains an unexpected date. Older desktop versions may also miss some of Google's sidecar filename formats.
+
+Before retrying:
+
+1. Update to the current stable [desktop app](https://ente.com/download/desktop).
+2. Keep the original Takeout ZIPs and a separate backup of any files you plan to change or remove.
+3. Extract all parts of the same Takeout into one combined folder. Merge matching album folders so their media and JSON files are together. Keep the album subfolders; do not flatten the files or leave each ZIP in its own numbered folder tree.
+4. Check a few affected photos and their matching JSON files before attempting a larger repair.
-- The photo's Exif data has a different date than Google's metadata JSON
-- The JSON file wasn't matched with the photo during import
+**Repeating the import does not rewrite dates on files that Ente skips as already uploaded.** Updating the app or fixing the source folder alone does not change those existing items.
-To fix this:
+For photos already in Ente, you can select the affected items in the desktop app and use **Fix time** to choose the correct date. If you need to reimport dates from the Takeout sidecars, contact [[email protected]](mailto:[email protected]) for help with an affected-only reimport. Before removing anything, verify that your backup opens and includes the originals and matching JSON files. Do not delete your entire library or empty Trash just to test a date repair.
-1. Make sure you unzipped all Google Takeout zips into one parent folder (with subfolders kept as-is)
-2. Import that parent folder (not individual zips)
-3. This ensures Ente can match JSON files with their photos
+If an import is still running, [stop the upload](/photos/migration/from-local-hard-disk#stop-and-resume-an-upload) before cleanup. Files still present in the selected source can be uploaded again during that import or a later retry.
## Editing Metadata
@@ -196,6 +204,8 @@ Ente will store your corrections and sync them across all your devices.
Yes! When you edit metadata (dates, locations, descriptions) in Ente, the **original file is never modified**. Your edits are stored separately.
+This also means that changing a location in Ente does not strip embedded GPS from the original or update the copy in your phone's photo library. Before sharing a file without location data, see [what metadata recipients can see](#shared-metadata-visibility).
+
When you export your photos:
- You get the exact original file
@@ -311,36 +321,34 @@ Ente is a photos app, not a file system backup app. Customers for whom the creat
### Does the date taken of a file change when the file is downloaded or exported? {#date-taken-preservation}
-No, the date taken (or "date time") remains the same and is preserved in the EXIF of the file. However, the creation date and modification date are changed as stated in the above FAQ.
+Ente preserves the original file and its embedded metadata. If the original contains an EXIF capture date, that value remains in the file. Ente does not add or rewrite an EXIF date just because a different date appears in Ente.
-### Can I modify the original files during export? {#modify-originals}
+A date imported from a Google Takeout JSON file, or changed later in Ente, is stored separately. A library export includes that date in a metadata JSON sidecar. Another app needs to read the sidecar to use it.
-No. Ente guarantees that you will get back the _exact_ same original photos and videos that you imported. The modifications (e.g. date changes) you make within Ente will be written into a separate metadata JSON file during export so as to not modify the original.
+See [original files during export](#modify-originals) and [file-system creation times](#file-creation-time).
-This ensures:
+### Can I modify the original files during export? {#modify-originals}
-- You always have access to originals
-- Your edits are preserved separately
-- You can use the metadata JSON with other tools
+No. Ente exports the original photos and videos without changing their embedded metadata. Metadata imported from Google Takeout JSON files and changes you make in Ente are written separately to metadata JSON files during library export.
-### How can I read the corrected date for a photo from my Ente export? {#read-corrected-date-export}
+Keep those sidecars with the originals when transferring to another app that supports them. See [the export metadata format](#export-data-preserve-metadata). To export selected albums with their metadata, you can also use [CLI photo export](/photos/features/utilities/cli#exporting-photos).
-Ente never modifies your original files, so corrected dates are not written back into the photo's EXIF. Instead, they live in the metadata JSON sidecar that ships alongside the file in your export.
+### How can I read the date used by Ente from my export? {#read-corrected-date-export}
-To check either:
+Ente does not write imported or corrected dates back into the original file. To compare the values:
-- **Original embedded EXIF**: use a tool like [exiftool](https://exiftool.org/) on the photo file itself.
-- **Corrected date set in Ente**: open the matching JSON in `metadata/` with any text or JSON viewer and look at `photoTakenTime`.
+- **Original embedded date**: inspect the EXIF metadata in the photo file, for example with [ExifTool](https://exiftool.org/).
+- **Date used by Ente**: open the matching JSON file in the export's `metadata/` folder and read `photoTakenTime`.
-If a photo has no original EXIF date and no Ente correction, the JSON will reflect Ente's best-guess fallback (filename or upload time).
+The exported date can come from the original metadata, an imported Takeout sidecar, a date inferred during import, or a later correction in Ente. The original file and the sidecar can therefore contain different dates.
### Why do some exported photos show the wrong date when imported into another app? {#wrong-export-date-other-app}
-Ente exports the original file untouched and writes the corrected date to a separate JSON sidecar (Google Takeout format). Other apps will only show the right date if they read that JSON.
+Another app may be reading only the original file's embedded date. Ente leaves that file unchanged. Dates imported from Google Takeout sidecars, inferred during import, or corrected in Ente are included in the export's metadata JSON sidecars.
-This shows up most often with files that never had a proper EXIF date to begin with, for example, WhatsApp forwards or screenshots, where Ente had to fall back to the filename or upload time. The original file simply has no embedded date for the new app to read.
+If the original has no EXIF capture date, downloading the image alone does not add one. If its EXIF date differs from the date shown in Ente, the original embedded value remains unchanged too.
-If the importing app supports Google Takeout-style JSON, keep the `metadata/` folder alongside the photos when transferring. Learn more at [Does the exported data preserve metadata?](#export-data-preserve-metadata).
+Keep the `metadata/` folder with the photos, and check whether the destination app reads Google Takeout-style JSON and accepts that folder layout. See [the export metadata format](#export-data-preserve-metadata) and [how to check the exported date](#read-corrected-date-export).
## Platform-Specific Behavior
diff --git a/docs/docs/photos/faq/migration.md b/docs/docs/photos/faq/migration.md
index a6acbb7e7d..25323eb23e 100644
--- a/docs/docs/photos/faq/migration.md
+++ b/docs/docs/photos/faq/migration.md
@@ -29,18 +29,21 @@ For example, `flower.jpeg` might be in one zip and `flower.json` in another. Thi
**Best practice**: We [recommend](/photos/migration/from-google-photos/) unzipping all of your Google Takeout zips into a single parent folder, keeping subfolders as-is (do not flatten files), then importing that parent folder into Ente. This way, we can always correctly map photos and their metadata.
-### Why are my Google Photos dates wrong after import? {#google-photos-dates-wrong}
+### What if my Takeout download is unfinished or too large for my computer? {#takeout-download-incomplete}
+
+Download every ZIP part in the same Takeout export before importing. A `.crdownload` file is an unfinished Chrome download and may contain part of an archive with many photos. [Resume it or download that archive part again](https://support.google.com/chrome/answer/2898334/fix-file-download-errors?hl=en-GB). Renaming it to `.zip` does not complete the download.
+
+An external drive can provide space for the ZIPs and extracted files. Keep it connected while importing. It does not reduce the data you need to download from Google and upload to Ente.
-If the dates appear incorrect after importing from Google Takeout, it's usually because:
+Once all parts are complete, follow the [Takeout import steps](/photos/migration/from-google-photos/) to combine their contents while keeping album subfolders. Keep the original export until you have checked the imported library and verified another backup.
-- The photo's Exif data has a different date than Google's metadata JSON
-- The JSON file wasn't matched with the photo during import
+For an interrupted upload after the source has downloaded, see [retrying failed uploads](#can-i-retry-failed-uploads).
+
+### Why are my Google Photos dates wrong after import? {#google-photos-dates-wrong}
-To fix this:
+Ente may not have matched a photo with its Google Takeout JSON sidecar. Use the current stable desktop app and combine all parts of the Takeout while preserving album subfolders.
-1. Make sure you unzipped all Google Takeout zips into one parent folder (with subfolders kept as-is)
-2. Import that parent folder (not individual zips)
-3. This ensures Ente can match JSON files with their photos
+Repeating an import can skip files already uploaded, so it does not automatically repair their dates. Keep your original Takeout and verify a separate backup before removing or reimporting anything. Follow the [date-repair guidance](/photos/faq/metadata-and-editing#google-photos-dates-wrong) for checking samples, correcting dates, and getting help with an affected-only reimport.
### Can I retry failed uploads?
diff --git a/docs/docs/photos/faq/search-and-discovery.md b/docs/docs/photos/faq/search-and-discovery.md
index e291dc6d8d..e6fce22f0b 100644
--- a/docs/docs/photos/faq/search-and-discovery.md
+++ b/docs/docs/photos/faq/search-and-discovery.md
@@ -112,6 +112,10 @@ Machine Learning enables features like face recognition and magic search.
Local processing controls whether the current device performs the indexing work itself. When local processing is on, the device downloads photos, runs the ML models, and builds indexes locally.
+Local processing describes where the indexing work happens. While signed in, face recognition and Magic search index photos backed up to Ente. A photo being visible in the device gallery does not make it eligible for signed-in indexing if it has not been backed up.
+
+In [Gallery Mode](/photos/faq/gallery-mode), the mobile app can index local photos it has permission to access while you are signed out.
+
If local processing is turned off, that device skips the heavy work and can instead use indexes created by another device, such as your desktop.
This can be useful on phones with low memory or limited performance.
diff --git a/docs/docs/photos/faq/security-and-privacy.md b/docs/docs/photos/faq/security-and-privacy.md
index c3e898a840..2f7bf7cf7c 100644
--- a/docs/docs/photos/faq/security-and-privacy.md
+++ b/docs/docs/photos/faq/security-and-privacy.md
@@ -70,15 +70,21 @@ Your **recovery key is a 24-word phrase** that is the ONLY way to recover your a
⚠️ **Your recovery key is different from verification codes**. Verification codes are temporary 6-digit numbers sent to your email. Your recovery key is a permanent 24-word phrase.
+The same Ente account uses the same recovery key in Photos, Auth, and Locker. Separate accounts have separate keys. Backup-code lists issued by other websites belong to those websites and cannot be used as your Ente recovery key. Learn [which recovery key or backup codes you need](/auth/faq/#recovery-key-or-backup-codes).
+
### How do I find my recovery key? {#find-recovery-key}
+If you previously downloaded your recovery key, search your Downloads folder for `ente-recovery-key.txt` (or search for `recovery-key.txt`). If you saved it elsewhere, check that folder too. Keep the file private.
+
**If you're still logged in to Ente on any device:**
-Open `Settings > Account > Recovery key`, enter your password to view your 24-word recovery key, and **save it immediately** in a secure location.
+Open `Settings > Account > Recovery key`, enter your password to view your 24-word recovery key, and save it in a secure location. Keep that device signed in while you resolve any access problems.
+
+**If you're logged out of all devices:**
-**If you're logged out of all devices and don't have your recovery key:**
+If you still know your password and can complete the required sign-in checks, sign in and save your recovery key. If you have lost access to a second factor, see [recovering access to 2FA](#two-factor-auth).
-Unfortunately, there is no way to recover your account. This is an inherent property of end-to-end encryption - for your privacy and security, only you have access to your data.
+If you have lost both your password and recovery key, Ente support cannot reconstruct your encryption keys or decrypt your data. See [account recovery](#account-recovery) for the available recovery options.
### How should I store my recovery key? {#store-recovery-key}
@@ -103,21 +109,22 @@ Unfortunately, there is no way to recover your account. This is an inherent prop
If you've forgotten your password and are logged out everywhere:
-1. Open the login page (on any platform)
-2. Enter your email address
-3. Click "Forgot Password"
-4. Enter your 24-word recovery key
- - Type each word separated by a single space
- - All lowercase, no punctuation
- - Example format: `word1 word2 word3 ... word24`
-5. Create a new password
-6. Log in with your new password
+1. Open the login page.
+2. Enter your email address.
+3. Choose **Forgot Password** and complete the sign-in checks shown by the app.
+4. Enter the 24 words of your recovery key in their original order.
+ - Separate words with a single space.
+ - Use lowercase letters without punctuation or manually inserted line breaks.
+ - The field may wrap text automatically; do not press Enter between words.
+5. Create a new password.
+6. Sign in with the new password.
**Common issues:**
-- **"Invalid recovery key"**: Check for typos, extra spaces, or missing words
-- **Recovery key not working**: Make sure you're using the recovery key (24 words), not a verification code (6 digits)
-- **Still can't access account**: Contact [[email protected]](mailto:[email protected]) - we may be able to help verify account ownership for account deletion, but cannot recover your data
+- **Invalid recovery key:** Check for typos, missing or reordered words, extra spaces, and manually inserted line breaks. Use the key for this Ente account and server.
+- **Wrong kind of code:** Your Ente recovery key is a 24-word phrase. An email verification code or another website's backup codes cannot replace it.
+- **Error after submitting:** A generic error can also involve a connection problem. See [verification troubleshooting](/auth/faq/#sync-password-recovery-failures) before repeating the reset.
+- **Still unable to continue:** Contact [[email protected]](mailto:[email protected]) with the error text and app version. Never send the recovery words or your password. Support cannot reconstruct your recovery key or decrypt your data.
### Can I change my password? {#change-password}
@@ -136,6 +143,10 @@ You can set up 2FA in the settings of our mobile or desktop apps.
Warning: if you use the same account in Ente Auth, enabling 2FA in Ente Photos also enables it for Ente Auth, which can be a problem if you store your Ente account's 2FA code inside Ente Auth itself. See [Enteception](/auth/faq/enteception/).
+If you lose access to your authenticator or passkey, use your Ente recovery key through the recovery option shown during sign-in. If you also cannot find the recovery key but still know your password, contact [[email protected]](mailto:[email protected]) from your registered email address. After verifying account ownership, support may be able to help with the lost second factor. Email access alone is not sufficient, and assistance is not guaranteed.
+
+Tell support whether you are being asked for an authenticator code, a passkey, or both, since these can be separate sign-in checks. Never send your password, recovery key, authenticator setup key, or current codes. Support cannot decrypt your data or replace a forgotten password without an available recovery method.
+
### Can I use app lock to protect Ente Photos? {#app-lock}
Yes. You can protect the Ente Photos app with an additional lock screen.
diff --git a/docs/docs/photos/faq/sharing-and-collaboration.md b/docs/docs/photos/faq/sharing-and-collaboration.md
index 3cd5b34845..91f35b050a 100644
--- a/docs/docs/photos/faq/sharing-and-collaboration.md
+++ b/docs/docs/photos/faq/sharing-and-collaboration.md
@@ -407,22 +407,24 @@ Make sure you have sufficient storage available if you're expecting many people
### Can I let others view a shared album without allowing download of the photos? {#disable-downloads-public-link}
-Yes. When creating or managing a public link, you can turn off downloads.
+You can hide Ente's download option for a public link. In the link settings, turn off **Download photos** on mobile or **Allow downloads** on web/desktop.
-Open the album, create or manage the public link, and disable **Allow downloads**.
+This is a viewer control, not copy protection. Anyone who can view the photos or videos may still save copies using browser features or external tools, take screenshots, or record their screen. Do not rely on this setting to prevent copying of the original files or their metadata.
-This lets people view the album through the link without showing them a download option.
+For a quick link on mobile, open **Albums**, tap the down-arrow, choose **Links**, open the link album, and tap the **link icon**. This opens **Link settings**, where you can turn off **Download photos**.
+
+See [Edit link settings](/photos/features/sharing-and-collaboration/public-links#edit-link-settings) for the other link types and platforms.
### Can I set limits on public links? {#link-limits}
-Yes! Public links (including collect links) support several protective features:
+Yes! Public links (including collect links) support these controls:
-- **Link expiry**: Set the link to automatically expire after a duration you define
-- **Device limits**: Limit how many devices can access the link (a "device" is identified by the combination of IP address and browser/app, so the same browser on a different network counts as a separate device)
-- **Password protection**: Add an additional password that users must enter to access the link
-- **Prevent downloads**: Disable the option to download original photos (though screenshots can't be prevented)
+- **Link expiry**: Set when the link stops working
+- **Device limits**: Limit access through the link. Different browsers or app access contexts can be counted separately, and using a phone that opened the link before does not guarantee continued access. See [device limits](/photos/features/sharing-and-collaboration/public-links#device-limits)
+- **Password protection**: Require a password before viewers can access the link
+- **Download control**: Hide Ente's download option. Viewers may still save copies with browser features or external tools, take screenshots, or record their screen
-These options help you maintain control over who can access and contribute to your shared albums.
+These settings help manage access to the link, but they cannot prevent someone who can view the content from copying it. See [download-control limitations](#disable-downloads-public-link).
### Can I stop people from adding more photos to a collect link? {#disable-collect-link}
diff --git a/docs/docs/photos/faq/storage-and-plans.md b/docs/docs/photos/faq/storage-and-plans.md
index 9fdd4666fc..4e8ded0f82 100644
--- a/docs/docs/photos/faq/storage-and-plans.md
+++ b/docs/docs/photos/faq/storage-and-plans.md
@@ -126,6 +126,8 @@ If a free account has no active paid subscription and remains inactive for 12 co
If you have configured Legacy with trusted contacts, we will notify those trusted contacts as well, so they have a chance to recover the account if needed.
+Visitors opening or viewing your public albums do not count as you using your account. Do not rely on public-link views to keep a free account active.
+
To keep the account and its data, simply sign in before the date mentioned in the emails.
### What are the limitations of the free plan? {#free-plan-limits}
@@ -336,10 +338,18 @@ In case you do not have access to such an email address, please send us proof (s
Please note that these discounts are valid for a year, after which you may reapply to reclaim the discount.
+**Already subscribed?**
+
+Contact [[email protected]](mailto:[email protected]) before your next renewal invoice is generated so we can review your eligibility and help renew the discount on your existing subscription. Include the email address registered with Ente if it differs from your institute email.
+
+You do not need to cancel, resubscribe, or change your billing interval just to look for a coupon field. If an invoice has already been issued, contact us about the options for your account. An adjustment or refund is not automatic.
+
## Discount Codes and Referrals
### How do I apply a discount code to my subscription? {#apply-discount-code}
+For renewal of an existing student discount, follow the [student discount instructions](#student-discount) instead of changing your plan to enter a promotional code.
+
If you have a discount code (e.g., from partnerships like Kagi Friends 25% off), follow these steps carefully:
⚠️ **CRITICAL: You MUST apply the discount code BEFORE purchasing your subscription.** Discount codes cannot be applied retroactively to existing purchases.
@@ -441,6 +451,10 @@ We support **annual** subscriptions over PayPal.
- You must email from the same email address registered with your Ente account
- Invoice generation is manual, so expect a response within 1-2 business days
+**Renewing a PayPal plan**
+
+PayPal plans are renewed manually. Before your paid period ends, email [[email protected]](mailto:[email protected]) from your registered Ente email address and mention the annual plan you want to renew. We will send the payment instructions for your renewal.
+
### Does Ente store my card details? {#card-security}
Ente does not store any of your sensitive payment related information.
@@ -493,15 +507,11 @@ When your subscription expires, you enter a **30-day grace period** before your
- Download all photos to your computer or NAS
- Learn more in the [Export guide](/photos/migration/export/)
-**Can I get my free plan back after subscription expires?**
+**Can I get my free plan back after my subscription expires?**
-Yes! If you had data exceeding the free 10 GB limit and your subscription expired:
+Contact [[email protected]](mailto:[email protected]) if you want to return to the free plan after a paid subscription expires. Your account may need to be switched back by support even if your usage is already within the free 10 GB allowance. You do not need to delete photos just to meet that allowance if you are already below it.
-- Your data enters the 30-day grace period
-- To restore access to your data on the free plan, contact [[email protected]](mailto:[email protected])
-- We can restore your account to the free plan if you're within the grace period
-- You'll need to delete data to get under the 10 GB limit
-- Once your account is back on the free plan, the [inactive free-account policy](#inactive-free-account) applies if the account is not used for 12 consecutive months. We will notify you, any family plan members, and any Legacy trusted contacts multiple times before any account deletion.
+If your usage is above the free allowance, contact support about your options. Keep a verified export of anything you want to retain before removing files.
**What about subscriptions purchased through App Stores?**
@@ -626,13 +636,23 @@ You will be able to see all of your previous invoices, with details regarding th
If you would like to change your payment method entirely (e.g., switch between App Store, Play Store, PayPal, or crypto), please contact [[email protected]](mailto:[email protected]).
+**Switching from Apple to direct billing**
+
+1. Cancel renewal in your Apple subscription settings. Cancelling renewal can leave your current paid period active until the end date shown by Apple.
+2. Contact [[email protected]](mailto:[email protected]) about switching the same Ente account to direct billing. Support can check when your account can be moved to the free plan so you can purchase directly.
+3. Once the account is ready, sign in to [photos.ente.com](https://photos.ente.com) with the same Ente email address and buy your plan there. Purchasing again inside the iOS app uses Apple billing and may reactivate that subscription.
+
+Apple decides requests for refunds of App Store purchases. Contacting Ente or cancelling renewal does not guarantee a refund.
+
### How can I cancel my subscription? {#cancel-subscription}
-You can cancel your subscription via Settings > click on the Storage (subscription) card at the top > Cancel subscription.
+For a subscription purchased directly from Ente, open `Settings > Storage/Subscription > Cancel subscription`, or `Settings > Account > Manage subscription > Cancel subscription`.
+
+For a subscription purchased through Apple or Google Play, cancel renewal in that store's subscription settings. Check the end date shown by the store; cancelling renewal does not necessarily end the current paid period immediately.
-This can also be done via Settings > Account > Manage subscription > Cancel subscription.
+If you want to switch from Apple to direct billing, follow the [payment-provider transition steps](#update-payment).
-After cancellation, you'll have access to your data for 30 days, after which it will be deleted. Make sure to export your photos before the grace period ends if you want to keep them.
+Cancelling renewal does not delete your Ente account. Your paid plan continues until its expiry date. See [What happens when my subscription expires?](#subscription-expires) for what happens next. Make sure to export your photos before the grace period ends if you want to keep them.
If support helps move your account back to the free plan, the [inactive free-account policy](#inactive-free-account) applies if the account is not used for 12 consecutive months. We will notify you, any family plan members, and any Legacy trusted contacts multiple times before any account deletion.
@@ -660,7 +680,9 @@ Open Settings in the Ente app. The registered email address will appear at the v
### What should I do if I received this email? {#inactive-account-action}
-Simply sign in to the account mentioned in the email before the date specified. This will mark the account as active.
+Sign in to the account named in the email before the date specified. Check the registered email address in the app to make sure you are using the correct account. Signing in marks that account as active.
+
+Visitors viewing your public albums do not replace signing in yourself. For details, see the [inactive free-account policy](#inactive-free-account).
### I think this email was sent by mistake {#inactive-account-mistake}
diff --git a/docs/docs/photos/faq/troubleshooting.md b/docs/docs/photos/faq/troubleshooting.md
index 07a335a60e..b7c2b044bb 100644
--- a/docs/docs/photos/faq/troubleshooting.md
+++ b/docs/docs/photos/faq/troubleshooting.md
@@ -16,6 +16,14 @@ This page helps you solve common issues with Ente Photos. Jump to the section th
## Upload Issues
+### Why are uploads or sign-in blocked after my paid plan expires? {#expired-subscription-access}
+
+Check whether your Photos subscription has expired, even if your usage is within the free allowance or you can still use Ente Auth. A Photos subscription restriction can sometimes appear as a sign-in or verification failure.
+
+Contact [[email protected]](mailto:[email protected]) to check your subscription status and discuss renewal or returning to the free plan. Do not delete your account or reset two-factor authentication just to troubleshoot an expired subscription.
+
+See [what happens when a subscription expires](/photos/faq/storage-and-plans#subscription-expires).
+
### Why are my large videos failing to upload? {#video-upload-failures}
If large video files (300-700+ MB) are failing to upload or getting stuck, try these solutions:
@@ -122,6 +130,18 @@ If your photos or videos aren't uploading to Ente, try these troubleshooting ste
- Files larger than 10 GB cannot be uploaded
- If a valid file isn't uploading, contact [[email protected]](mailto:[email protected])
+### What does “This upload API is no longer supported” mean? {#unsupported-upload-api}
+
+If Ente reports **This upload API is no longer supported. Please update your app.**, update Ente on the device that is trying to upload. Updating another device does not update the uploading app.
+
+1. Use the same app store or distribution channel you originally installed from. See [how to update Ente](/photos/faq/account-creation#update-latest).
+2. If you use F-Droid, refresh its repository information and check the Ente Photos listing for an update.
+3. Open the updated app and check the backup status again.
+
+If the same error remains, [send logs from the affected app](#sharing-logs), along with its version and installation source.
+
+Before changing Android distribution channels, read [the channel-switching note](/photos/getting-started/installation#android). Keep unsynced originals and a working way to access your Ente account; do not uninstall your existing app or clear its data just to try an update.
+
### Why does upload show "Waiting to upload"? {#waiting-to-upload}
This usually indicates a network connectivity issue:
@@ -654,7 +674,7 @@ This removes thumbnails and previews that Ente can recreate. It does not remove
### How do I share debug logs with support? {#sharing-logs}
-If you need to contact support, debug logs help us diagnose issues faster.
+Debug logs help us investigate problems. Collect them from the app and device where the issue occurs; for example, send desktop logs for a desktop upload problem.
> [!NOTE]
>
@@ -666,7 +686,7 @@ Open `Settings > Help & Support > Export logs`. This will download logs which yo
**On desktop:**
-Open `Settings > Support > Help` to view logs location, then go back to `Settings > Support` to open your email client. Attach the logs and describe your issue.
+Open **Settings > Help > View logs**. Review the notice and select **View logs** to open the logs folder. Attach the relevant logs to an email to [[email protected]](mailto:[email protected]) and describe the problem. You can also open your email app through **Settings > Help > Support**.
**Desktop log locations:**
diff --git a/docs/docs/photos/features/account/index.md b/docs/docs/photos/features/account/index.md
index 3cb5c8080f..9e371c267c 100644
--- a/docs/docs/photos/features/account/index.md
+++ b/docs/docs/photos/features/account/index.md
@@ -11,6 +11,8 @@ Your Ente account is the foundation for securely storing and accessing your phot
One Ente account works with Ente Photos, Ente Auth, and Ente Locker. You can use one account for all three, or create a separate account for each.
+This shared account applies within the same Ente service or server. If you create a new account on an independent self-hosted server, it is separate from your hosted Ente account even when both use the same email address. Keep separate, clearly labeled credentials and recovery keys, and check the server endpoint before signing in or resetting a password. See the [self-hosting setup guide](/self-hosting/installation/post-install/#step-1-creating-first-user).
+
> [!NOTE]
>
> If you use the same account for both Photos and Auth and enable 2FA for your Ente account (stored in Ente Auth), this creates a circular dependency. We recommend either:
diff --git a/docs/docs/photos/features/albums-and-organization/albums.md b/docs/docs/photos/features/albums-and-organization/albums.md
index a2f34c07a3..7c066301b2 100644
--- a/docs/docs/photos/features/albums-and-organization/albums.md
+++ b/docs/docs/photos/features/albums-and-organization/albums.md
@@ -28,10 +28,12 @@ Create albums to organize your photos and videos into collections.
![Albums grid and New album dialog side by side on Ente Photos mobile](https://docs-assets.ente.com/screenshots/phone-albums-create-duo.png){width=780px}
-- Open the **Albums** tab
-- Tap the **Add new** button
-- Enter a name for your album
-- Tap **Create**
+1. Open the **Albums** tab
+2. Select **Ente** at the top
+3. Tap **Create album**
+4. Enter a name and tap **Create**
+
+The **Device** view shows folders from your phone and does not offer this Ente-album creation tile. If **Create album** is missing, scroll to the top, select **Ente**, and clear any active album search.
### On web / desktop
@@ -44,10 +46,20 @@ Create albums to organize your photos and videos into collections.
You can also create albums by uploading photos from your device, manually adding photos to new albums, or automatically through features like [watch folders](/photos/features/backup-and-sync/watch-folders) on desktop.
+## Add existing photos to an album {#add-existing-photos}
+
+Creating an empty album using the steps above does not move existing photos into it. To organize photos already in Ente, select them in your gallery or an album and choose **Add to album**. On desktop, choose one destination at a time. On mobile, you can select multiple destination albums.
+
+For photos in **Uncategorized** on desktop, first use **Move** in the action bar to put them in one album. Open that album and use **Add to album** for any additional destinations. See [organizing Uncategorized photos](/photos/features/albums-and-organization/uncategorized#organize-uncategorized-photos).
+
+Use **Upload** when you want to import new local files from your computer.
+
## Rename album
Personalize your albums by giving them a meaningful name.
+Renaming an Ente album does not rename the corresponding folder on your phone. If that album is already the destination for mobile automatic backup, the existing backup connection continues to use it after the rename. Changing its name does not choose a new backup destination.
+
### On mobile
![Album overflow menu on Ente Photos mobile showing Edit details, Sort by, and Pin options](https://docs-assets.ente.com/screenshots/phone-album-overflow-menu.png){width=320px}
diff --git a/docs/docs/photos/features/albums-and-organization/uncategorized.md b/docs/docs/photos/features/albums-and-organization/uncategorized.md
index c0e4952f46..b7b2f5a168 100644
--- a/docs/docs/photos/features/albums-and-organization/uncategorized.md
+++ b/docs/docs/photos/features/albums-and-organization/uncategorized.md
@@ -14,6 +14,19 @@ description: Uncategorized items in Ente Photos
>
> This does not include photos uploaded by others.
+## Organize Uncategorized photos {#organize-uncategorized-photos}
+
+**On desktop:**
+
+1. Open Uncategorized and select the photos you want to organize
+2. Choose **Move** in the action bar and select a destination
+3. To place the same photos in more albums, open the first destination album, select them, and choose **Add to album**
+4. Repeat for each additional album; the desktop picker uses one destination at a time
+
+**On mobile:** Select the photos and use **Add to album** to choose one or more destination albums.
+
+Use these album actions for photos already in Ente. **Upload** selects new files from your computer. A photo can belong to multiple Ente albums while counting only once toward your storage.
+
## Cleaning up Uncategorized items
![Uncategorized album with photos on Ente Photos mobile and web](https://docs-assets.ente.com/screenshots/duo-uncategorized-view.png){width=900px}
diff --git a/docs/docs/photos/features/search-and-discovery/index.md b/docs/docs/photos/features/search-and-discovery/index.md
index 9256f6e793..6aaeef6dcc 100644
--- a/docs/docs/photos/features/search-and-discovery/index.md
+++ b/docs/docs/photos/features/search-and-discovery/index.md
@@ -18,13 +18,15 @@ You can quickly access search using the keyboard shortcut:
This focuses the search bar from anywhere in the app, letting you start searching immediately.
-### Date search
+### Date search {#date-search}
-Search for photos by specific dates, months, or years. Simply type a date in the search bar:
+Type a date, month, or year in the search bar **without quotation marks**. For example:
-- "January 2024" - finds all photos from that month
-- "2023" - finds all photos from that year
-- Specific dates like "July 15, 2024"
+- January 2024
+- 2023
+- July 15, 2024
+
+Then select the matching date suggestion under **Moments** on mobile or **Date** on desktop. This searches by date. Selecting a Magic search suggestion instead searches the visual content of your photos.
### File name search
diff --git a/docs/docs/photos/features/search-and-discovery/machine-learning.md b/docs/docs/photos/features/search-and-discovery/machine-learning.md
index ec390af5e7..175ffe3aa1 100644
--- a/docs/docs/photos/features/search-and-discovery/machine-learning.md
+++ b/docs/docs/photos/features/search-and-discovery/machine-learning.md
@@ -56,6 +56,12 @@ Open `Settings > Preferences > Machine learning` and enable **Machine learning**
After enabling machine learning, the app needs to download and index your photos locally.
+### Which photos are indexed? {#which-photos-are-indexed}
+
+While you are signed in, face recognition and Magic search index photos backed up to Ente. Turning on local indexing does not include unbacked photos just because they are visible in your device gallery.
+
+On mobile, [Gallery Mode](/photos/faq/gallery-mode) can index local photos that Ente has permission to access while you are signed out. Gallery Mode is not available in the desktop app.
+
### What happens during indexing
1. **Download**: The app downloads your original photos to your device
diff --git a/docs/docs/photos/features/sharing-and-collaboration/public-links.md b/docs/docs/photos/features/sharing-and-collaboration/public-links.md
index b194d41c3d..37511e338e 100644
--- a/docs/docs/photos/features/sharing-and-collaboration/public-links.md
+++ b/docs/docs/photos/features/sharing-and-collaboration/public-links.md
@@ -60,10 +60,13 @@ You can create a quick link in any of these ways:
**Managing quick links:**
-- View all quick links in the Albums tab under "Links" (tap the 'v' icon at the right)
+- On mobile, open **Albums**, tap the down-arrow at the right, and choose **Links**
+- Open a link album and tap the **link icon** to open **Link settings**, including the **Download photos** control
- Quick links can be converted to regular albums if needed
- Removing a link doesn't delete the photos
+See [Edit link settings](#edit-link-settings) for the full steps and [download-control limitations](#prevent-downloads) before sharing.
+
## Link features
Public links support powerful customization, security, and control features:
@@ -141,19 +144,13 @@ A "device" is determined by the combination of IP address and browser/app (User-
![Device limit row highlighted in Manage link on Ente Photos web](https://docs-assets.ente.com/screenshots/web-album-manage-link-device-limit-callout.png){width=720px}
-### Prevent downloads
-
-Disable the option to download original quality photos. Recipients can still view photos and take screenshots, but can't download the original files.
+### Download control {#prevent-downloads}
-**When to use:**
+Turn off **Download photos** on mobile or **Allow downloads** on web/desktop to hide Ente's download option for a public link.
-- Protecting professional work
-- Watermarked preview sharing
-- Limited distribution control
+Viewers can still see the photos and videos. They may also save copies using browser features or external tools, take screenshots, or record their screen. This setting does not guarantee that original files cannot be copied, and it does not remove their metadata.
-> [!NOTE]
->
-> This doesn't prevent screenshots or screen recording, but does make it harder for recipients to get high-quality copies.
+Use it when you want to hide the download button, but share only content you are comfortable allowing recipients to view and potentially copy.
![Allow downloads toggle highlighted in Manage link on Ente Photos web](https://docs-assets.ente.com/screenshots/web-album-manage-link-callout.png){width=720px}
@@ -232,17 +229,27 @@ Learn more in the [Custom domains guide](/photos/features/sharing-and-collaborat
- To see shared albums, open the Albums tab and use the "Shared" tab (albums you've shared) or the "Received" tab (albums shared with you)
- To see quick links, open the Albums tab, tap on 'v' icon at the right, then tap "Links"
-### Edit link settings
+### Edit link settings {#edit-link-settings}
![Manage link settings on Ente Photos web](https://docs-assets.ente.com/screenshots/web-album-manage-link-callout.png){width=720px}
-1. Find the link in your sharing list
-2. Tap/click the three dots menu
-3. Select "Edit link settings"
-4. Modify password, expiry, device limits, or other options
-5. Save changes
+**For a quick link on mobile:**
+
+1. Open **Albums**
+2. Tap the down-arrow at the right and choose **Links**
+3. Open the link album you want to change
+4. Tap the **link icon** to open **Link settings**
+5. Change the settings you need, such as **Download photos**, password, expiry, or device limit
-Changes apply immediately - anyone accessing the link will see the updated settings.
+**For a regular album link on mobile:**
+
+Open the album, tap the **Share icon**, and manage its public link.
+
+**On web/desktop:**
+
+Open the album, click the **share icon**, and choose **Manage link**. Change the existing link's settings, including **Allow downloads**, password, expiry, or device limit.
+
+Turning off **Download photos** or **Allow downloads** hides Ente's download control. It does not prevent copying through browser features, external tools, screenshots, or screen recording. See [download-control limitations](#prevent-downloads).
### Delete a link
@@ -285,6 +292,8 @@ Public links are end-to-end encrypted, but with an important caveat:
- Anyone with the link can decrypt and view the content
- The keys never reach Ente's servers (URL fragments aren't sent to servers)
+Metadata decrypts along with the photos, so public-link viewers can see details such as locations. There is no hide-location switch for a public link, and changing a location in Ente does not remove GPS embedded in the original file. For location-free sharing, use [separate copies with location metadata removed](/photos/faq/metadata-and-editing#shared-metadata-visibility).
+
**For sensitive content:**
- Use password protection for an additional security layer
@@ -310,6 +319,8 @@ Public links (including collect links and quick links) are available on all plan
- Create public links with no device limit
- Access all other premium features
+If you use a free account, visitors viewing your public albums do not keep your account active. Sign in to your own account and follow any inactivity notices you receive. See the [inactive free-account policy](/photos/faq/storage-and-plans#inactive-free-account).
+
## Related topics
- [Collaboration](/photos/features/sharing-and-collaboration/collaboration) - Collaborate with Ente users or collect photos from anyone
diff --git a/docs/docs/photos/getting-started/installation.md b/docs/docs/photos/getting-started/installation.md
index 5957e32215..7fa6f5cea6 100644
--- a/docs/docs/photos/getting-started/installation.md
+++ b/docs/docs/photos/getting-started/installation.md
@@ -18,6 +18,12 @@ Ente Photos for Android can be downloaded through multiple channels based on you
- [GitHub](https://github.com/ente/ente/releases?q=photos-v1)
- [Obtanium](https://apps.obtainium.imranr.dev/redirect?r=obtainium://app/%7B%22id%22%3A%22io.ente.photos.independent%22%2C%22url%22%3A%22https%3A%2F%2Fgithub.com%2Fente%2Fente%22%2C%22author%22%3A%22ente%22%2C%22name%22%3A%22Ente%20Photos%22%2C%22preferredApkIndex%22%3A0%2C%22additionalSettings%22%3A%22%7B%5C%22includePrereleases%5C%22%3Afalse%2C%5C%22fallbackToOlderReleases%5C%22%3Atrue%2C%5C%22filterReleaseTitlesByRegEx%5C%22%3A%5C%22%5C%22%2C%5C%22filterReleaseNotesByRegEx%5C%22%3A%5C%22%5C%22%2C%5C%22verifyLatestTag%5C%22%3Afalse%2C%5C%22dontSortReleasesList%5C%22%3Atrue%2C%5C%22useLatestAssetDateAsReleaseDate%5C%22%3Afalse%2C%5C%22releaseTitleAsVersion%5C%22%3Afalse%2C%5C%22trackOnly%5C%22%3Afalse%2C%5C%22versionExtractionRegEx%5C%22%3A%5C%22%5C%22%2C%5C%22matchGroupToUse%5C%22%3A%5C%22%5C%22%2C%5C%22versionDetection%5C%22%3Atrue%2C%5C%22releaseDateAsVersion%5C%22%3Afalse%2C%5C%22useVersionCodeAsOSVersion%5C%22%3Afalse%2C%5C%22apkFilterRegEx%5C%22%3A%5C%22ente-photos*%5C%22%2C%5C%22invertAPKFilter%5C%22%3Afalse%2C%5C%22autoApkFilterByArch%5C%22%3Atrue%2C%5C%22appName%5C%22%3A%5C%22%5C%22%2C%5C%22shizukuPretendToBeGooglePlay%5C%22%3Afalse%2C%5C%22allowInsecure%5C%22%3Afalse%2C%5C%22exemptFromBackgroundUpdates%5C%22%3Afalse%2C%5C%22skipUpdateNotifications%5C%22%3Afalse%2C%5C%22about%5C%22%3A%5C%22%5C%22%7D%22%2C%22overrideSource%22%3Anull%7D)
+> [!NOTE]
+>
+> F-Droid and the direct GitHub APK use different Android package IDs (`io.ente.photos.fdroid` and `io.ente.photos.independent`). Switching between them can install a separate copy of Ente rather than update the existing app. You may need to sign in and configure backup again.
+>
+> Before switching, preserve any photos that have not uploaded and make sure you can access your Ente account. Keep the existing app until you have verified access and backup in the new installation. For a routine update, use the current installation's channel first.
+
If you install the APK directly from GitHub, see [Verify the Ente Photos Android APK](/photos/getting-started/android-apk-signature).
## Desktop
diff --git a/docs/docs/photos/migration/from-google-photos/index.md b/docs/docs/photos/migration/from-google-photos/index.md
index b6b64bd800..5eb8b5fa09 100644
--- a/docs/docs/photos/migration/from-google-photos/index.md
+++ b/docs/docs/photos/migration/from-google-photos/index.md
@@ -33,7 +33,13 @@ Follow these steps to recover your data from Google Photos and preserve it with
![Google Takeout - Frequency and file size](google-photos-5.png)
-8. Wait for Google to send you your data.
+8. Wait for Google to prepare the export, then download **every ZIP part** listed for that export before starting the import.
+
+ A file ending in `.crdownload` is an unfinished Chrome download. It is not a photo or a completed ZIP, and it may represent an archive containing many photos and videos. [Resume the download or download that part again](https://support.google.com/chrome/answer/2898334/fix-file-download-errors?hl=en-GB); changing its filename does not complete it.
+
+ If your computer lacks space, you can download and extract the Takeout on an external drive with enough free space for the archives and extracted files. Keep the drive connected during import. You still need to download the export from Google and upload the files to Ente.
+
+ Keep the original ZIPs and extracted files until you have reviewed the import, checked important photos and dates, and verified another backup. See [unfinished or oversized Takeout downloads](/photos/faq/migration#takeout-download-incomplete).
9. Open [the Ente desktop app](https://ente.com/download/desktop), click **Upload**, and select **Google takeout**.
@@ -81,11 +87,15 @@ Follow these steps to recover your data from Google Photos and preserve it with
Learn more about stopping an upload, reviewing skipped or failed items, and retrying failures in [Import from Local Hard Disk](/photos/migration/from-local-hard-disk).
-Ente will parse Google's metadata and preserve everything with your photos, end-to-end encrypted!
+Ente reads the Google Takeout metadata it can match with your photos and videos, and encrypts it before upload. Check a sample of imported dates and review failed or skipped items before considering the migration complete.
----
+## Resume an import or correct imported dates {#resume-or-correct-import}
+
+If an Ente upload is interrupted, select the same source folder or files again. Ente skips matching files already uploaded to the target album and processes the rest. A skipped file keeps its existing metadata; retrying does not retroactively rewrite its date.
+
+Before cleaning up items in Ente, [stop any active import](/photos/migration/from-local-hard-disk#stop-and-resume-an-upload). Items still in the selected source can upload again. If you want to exclude items from a later import, prepare a separate working copy of the source and keep your original export unchanged.
-In case your uploads get interrupted, just drag and drop the folder or files again. Ente will automatically ignore already backed up files and upload just the rest.
+For incorrect dates, follow the [date-repair guidance](/photos/faq/metadata-and-editing#google-photos-dates-wrong). Keep your Takeout ZIPs, extracted originals, and matching JSON files until you have checked the imported library and verified another backup.
If you run into any issues during this migration, please check out our [Migration FAQ](/photos/faq/migration#importing-from-google-photos) page or reach out to [[email protected]](mailto:[email protected]) and we will be happy to help you!
diff --git a/docs/docs/self-hosting/installation/post-install/index.md b/docs/docs/self-hosting/installation/post-install/index.md
index 4768289ca0..ee6a138b46 100644
--- a/docs/docs/self-hosting/installation/post-install/index.md
+++ b/docs/docs/self-hosting/installation/post-install/index.md
@@ -15,6 +15,12 @@ Once Ente is up and running, the Ente Photos web app will be accessible on `http
Select **Don't have an account?** to create a new user. Follow the prompts to sign up.
+> [!IMPORTANT]
+>
+> Creating an account on a new self-hosted server creates a separate account, even if you use the same email address as your hosted Ente account. It has its own password, recovery key, and data; signup does not move or link your hosted account.
+>
+> Save a separate password-manager entry and recovery-key backup labeled with this server's address. Keep your existing hosted-account credentials and recovery key instead of overwriting them.
+
<div style="display: flex; gap: 10px;">
<img alt="Onboarding screen" src="/onboarding.png" style="width: 50%; height: auto;">
<img alt="Sign up page" src="/sign-up.png" style="width: 50%; height: auto;">
@@ -151,6 +157,8 @@ You can also install Ente Auth (if you are planning to use Auth) by following th
You can modify Ente mobile apps and CLI to connect to your server.
+Before signing in or starting account recovery, check that the app points to the intended server. Use the credentials and recovery key for the account created on that server. The same email address on Ente's hosted service and an independently set up self-hosted server does not make them the same account.
+
### Mobile
Tap the onboarding screen 7 times to modify developer settings. Enter your Ente server's endpoint.