Skip to content

armgit / ente

Public Imported from GitHub
0

πŸ’š End-to-end encrypted cloud for everything.

docs: add FAQs from recurring support questions

Shanthy17e17ec98dbe98
diff --git a/docs/docs/auth/faq/enteception/index.md b/docs/docs/auth/faq/enteception/index.md
index 4a74542ead..b4e154749e 100644
--- a/docs/docs/auth/faq/enteception/index.md
+++ b/docs/docs/auth/faq/enteception/index.md
@@ -11,7 +11,15 @@ There are multiple answers, none of which are better or worse, they just depend
We recommend that you ensure you store your recovery key in a safe place (writing it down on a paper is a good idea). This key can be used to bypass Ente 2FA in case you are locked out.
-Another option is to use a separate account for Ente Auth.
+Another option is to use a separate account for Ente Auth:
+
+1. Create a new Ente Auth account with a different email address.
+2. On your old account, export your codes: `Settings > Data > Export codes > Encrypted`.
+3. On the new account, import them: `Settings > Data > Import codes > Ente Encrypted Export`, then select the JSON file.
+4. Verify that all the codes match once imported into the new account.
+5. Once verified, log out of the old Auth account (you don't need to delete it - deleting it would also delete any Ente Photos or Ente Locker data tied to that account).
+
+Make sure to separately and clearly note down the password and 24-word recovery key for the new account.
Also, exporting the encrypted backup is another good way to reduce the risk (you can easily import the encrypted backup without signing in).
diff --git a/docs/docs/auth/faq/index.md b/docs/docs/auth/faq/index.md
index fc71ee0c80..5b00fb9866 100644
--- a/docs/docs/auth/faq/index.md
+++ b/docs/docs/auth/faq/index.md
@@ -5,6 +5,22 @@ description: Frequently asked questions about Ente Auth
# Frequently Asked Questions
+### Is Ente Auth free, including for corporate/business use? {#auth-free-corporate-use}
+
+Yes, Ente Auth is completely free, with no special conditions or licensing fees for business or corporate use.
+
+### Does Ente Auth support German (or other languages) on desktop? {#auth-desktop-language}
+
+Yes. Open `Settings > General > Language` in the app to change the display language, including German.
+
+### Can Ente Auth run fully offline with no connection to any server? {#auth-fully-offline}
+
+Yes. Choose **Use without backups** to use Auth entirely offline, with no account and no connection to Ente's servers. Learn more in [Using offline mode safely](/auth/features/offline-mode).
+
+### What support options does Ente Auth offer, and how often are updates released? {#auth-support-update-cadence}
+
+We provide email support at [[email protected]](mailto:[email protected]). Ente Auth apps are typically updated once a month, and we ship hotfixes sooner whenever something serious or a security concern comes up.
+
### How do I add a code to Ente Auth? {#add-code}
**If a service shows a QR code:**
@@ -186,3 +202,5 @@ Most of these failures come from network-level filtering between your device and
- A VPN routing traffic in a way that interferes with Ente endpoints.
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 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 - it's likely to work.
diff --git a/docs/docs/locker/faq/information-types.md b/docs/docs/locker/faq/information-types.md
index f5498c882b..b7fc4a8afa 100644
--- a/docs/docs/locker/faq/information-types.md
+++ b/docs/docs/locker/faq/information-types.md
@@ -52,6 +52,18 @@ Check the app for the complete list of supported formats.
Individual file uploads have size limits. Large files may need to be compressed or split before uploading. Check the app for current size limits.
+### How do I add a photo or image to Locker on iOS? {#locker-add-image-ios}
+
+**On iOS:**
+
+1. Open Ente Locker and tap the **+** button.
+2. Select **Document**.
+3. Choose **Photo Library** to pick an existing photo, or **Take Photo** to capture a new one.
+4. Add a descriptive title and select one or more collections.
+5. Tap **Save**.
+
+The image is added as a Document item, the same as a PDF or scan.
+
### How do I scan a physical document? {#locker-scan-document}
Use your phone's camera or a scanning app to create an image or PDF of the physical document, then upload it to Locker as a Document.
diff --git a/docs/docs/locker/features/legacy/legacy-kits.md b/docs/docs/locker/features/legacy/legacy-kits.md
index 17ed1b9ee0..d08237f624 100644
--- a/docs/docs/locker/features/legacy/legacy-kits.md
+++ b/docs/docs/locker/features/legacy/legacy-kits.md
@@ -21,7 +21,7 @@ The split uses Shamir's 2-of-3 secret sharing. Legacy Kit is the version we ship
## Create a Legacy Kit
-Legacy Kit creation and management are available in Ente Locker on mobile.
+Legacy Kit creation and management are available in **Ente Locker on mobile**.
**On mobile:**
diff --git a/docs/docs/photos/faq/backup-and-sync.md b/docs/docs/photos/faq/backup-and-sync.md
index f504101cdd..3d8cf8f3f2 100644
--- a/docs/docs/photos/faq/backup-and-sync.md
+++ b/docs/docs/photos/faq/backup-and-sync.md
@@ -28,6 +28,27 @@ 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.
+### I don't want everything to auto-upload. How do I control which photos back up? {#control-what-backs-up}
+
+Photos are automatically uploaded based on the folders selected for backup - Ente doesn't currently offer a way to back up only individual photos you pick one by one.
+
+To stop specific folders from backing up, open `Settings > Backup > Backed up folders` on mobile and unselect all, or just the ones you don't want backed up.
+
+You can also delete photos that are already backed up to Ente as well as on your device: long-press a photo (or select multiple), choose delete, and pick **Delete from Ente** to remove it from both places at once.
+
+After that, on the home gallery, photos that aren't backed up show a slashed cloud icon. See [What does the slashed cloud icon mean?](#slashed-cloud-icon) if you want to back one of them up later.
+
+### What does the slashed cloud icon mean, and how do I back that photo up? {#slashed-cloud-icon}
+
+A slashed cloud icon on a photo means it isn't backed up to Ente - usually because it's in a folder you haven't selected for backup, or because you deleted it from Ente while keeping it on your device.
+
+To back it up:
+
+- Long-press the photo and choose **Add to album**, or
+- Open the photo and tap the upward-facing arrow in the top-right corner (**Upload to Ente**)
+
+You can also open `Settings > Backup > Backup status` to check whether any photos in folders chosen for backup haven't uploaded yet.
+
### Can I backup only new photos without uploading my existing library? {#backup-only-new-photos}
Yes. You can enable this during signup/login on the permissions screen, or later via `Settings > Backup > Backup settings` by toggling on **Backup only new photos**.
@@ -234,6 +255,17 @@ Live Photos behave differently depending on how you share them:
- **Using "Download"**: Downloads the complete Live Photo (image + video)
- **Using "Share" button to save/download**: Only saves the still image
+### How do I stop Live Photos from autoplaying as I scroll through an album? {#live-photo-autoplay-album}
+
+On web and desktop, opening a Live Photo plays its motion once automatically. In an album full of iOS Live Photos, this means each one animates as you scroll to it. (The mobile app is different - there, Live Photos only play when you long-press them.)
+
+There isn't a permanent "always off" setting yet, but you can stop the autoplay for the rest of a viewing session:
+
+1. Open any Live Photo in the album.
+2. As it plays its one-time motion, click the live icon (circle with dot) on the photo to pause it.
+
+Pausing during that initial playback tells Ente you don't want autoplay, and every other Live Photo stays still for the rest of that session as you scroll through the album. If you fully close and reopen the viewer, repeat the step once to set it again.
+
### How do I restore Live Photos from Ente? {#restore-live-photos}
If you backed up your Live Photos to Ente and deleted them from your iPhone and iCloud, you can restore them as proper Live Photos (not as two separate files) using either of the methods below.
@@ -319,6 +351,12 @@ A few details to keep in mind:
- The picker shows the photos and videos available in your Ente gallery on that device.
- On iPhone, iOS does not currently let Ente plug into other apps' photo pickers in the same way.
+### Can Ente be my Android cloud media provider (system gallery source for photo picker)? {#android-cloud-media-provider}
+
+Not currently. Android's cloud media provider program, which lets an app supply photos into the system Photo Picker as a cloud source, is only open to apps nominated by device manufacturers (OEMs). There's nothing Ente can do on our end to opt in outside of that program.
+
+See our [GitHub discussion](https://github.com/ente/ente/discussions/1266#discussioncomment-10396221) for more context.
+
### Can Ente replace my default Photos or Camera gallery? {#ente-as-default-gallery}
Not as a full system gallery. On iPhone, tapping a photo from the camera or another app will still open Apple Photos because iOS does not allow third-party apps to replace that role.
@@ -777,3 +815,11 @@ Deduplication is based on the file's content hash, not on its thumbnail. Thumbna
- **Different upload times**: Older versions of Ente may have used different thumbnail generation code than newer versions.
The differing thumbnails don't affect deduplication. Ente still recognizes the files as exact duplicates and keeps a single underlying copy.
+
+### Which copy does Ente keep when it finds the same photo in multiple albums? {#dedup-which-copy-kept}
+
+When Ente finds the same photo across, say, three albums, it keeps just one underlying copy of the file and replaces the others with symlinks (references) pointing back to that copy. All three albums still show the photo, and you can scroll through any of them and see it there. The only thing that changes is that your storage quota goes down, since Ente is no longer storing three full copies of the same file.
+
+Deduplication isn't an album cleanup tool - if your goal is to have a photo appear in only one album instead of three, deduplication won't do that. It only makes storage more efficient while keeping every album looking the same. To remove a photo from a specific album, remove it from that album manually.
+
+If you later export your library, the file shows up in every album folder it belonged to - the symlinks become real copies again in your exported folders.
diff --git a/docs/docs/photos/faq/metadata-and-editing.md b/docs/docs/photos/faq/metadata-and-editing.md
index 281967f913..8731fc0a4e 100644
--- a/docs/docs/photos/faq/metadata-and-editing.md
+++ b/docs/docs/photos/faq/metadata-and-editing.md
@@ -29,6 +29,12 @@ The app still shows all the fields in the raw Exif data in the file info panel w
In particular, for the description associated with a photo, the exact logic to determine the description from the Exif when uploading the image can be seen [in this part of the code](https://github.com/ente/ente/blob/0dcb185744da469848b41b668fe4b647226b6fe2/web/packages/gallery/services/exif.ts#L609-L620).
+### Which Lightroom fields does Ente read - Caption, Title, Keywords, Copyright, Rating? {#lightroom-fields-read}
+
+Of these, Ente only reads the **Caption/Description** field. It looks at the XMP `dc:description` tag first, then falls back to the Exif `ImageDescription` tag, and this works for WebP too since Lightroom stores it in the file's XMP. That caption becomes your photo's caption in Ente - shown, editable, and synced consistently across mobile, desktop, and web with end-to-end encryption.
+
+**Title**, **Keywords**, **Copyright**, and **Rating** aren't currently read or indexed. They stay safely embedded in your original file - Ente never strips them - but Ente won't display or search them for now. If you rely on the caption, make sure your Lightroom export includes all metadata so it's actually written into the file.
+
### Where does Ente import photo dates from? {#photo-date-sources}
Ente will import the date for your photos from three places (in order of priority):
diff --git a/docs/docs/photos/faq/migration.md b/docs/docs/photos/faq/migration.md
index bbaa9b5aec..6163bd0046 100644
--- a/docs/docs/photos/faq/migration.md
+++ b/docs/docs/photos/faq/migration.md
@@ -119,6 +119,31 @@ If photos already uploaded without the right album assignment, Ente can't recons
2. Re-arrange the extracted Takeout contents into a single merged folder as shown above.
3. Re-upload through the desktop app.
+### Will removing duplicates delete photos from my "Photos from 20XX" or original albums? {#dedup-yearly-albums-safe}
+
+No. Deduplication keeps one copy of each duplicated file and replaces the other copies with symlinks (references) in every album that contained it - including both a "Photos from 20XX" album and your original Google Photos album. Nothing disappears from any album; the album structure stays untouched. All that's freed up is the storage the extra copies were using.
+
+Photos that Google re-compressed, edited, or whose metadata differs won't be caught by deduplication, since they no longer share the same file hash. Also, if you later export your library, the file will be exported into every album folder it belonged to again, since symlinks become real file copies on export.
+
+### Do "Photos from 20XX" yearly albums get recreated as I use Ente? {#yearly-albums-recreated}
+
+No. These albums aren't created by Ente - they come from Google Takeout, which sorts any photos that weren't in a specific album into "Photos from 2020", "Photos from 2021", and so on. When you imported, Ente created one album per Takeout folder.
+
+New photos you back up afterwards (for example, from your phone's camera) go to their normal device-folder albums, not into yearly albums. Changing a photo's date also does not move it into a yearly album. These yearly albums are a one-time import artifact - they won't regenerate or grow on their own.
+
+### Can I delete the yearly albums without losing my photos, and will that clear up duplicate storage? {#delete-yearly-albums}
+
+Yes, you can delete them safely, but do it in the right order.
+
+When you delete an album, Ente asks how to handle the photos inside - choose **Delete album, but keep photos**. Photos that also live in another album stay right where they are, and photos that were only in that yearly album move to Uncategorized (not deleted, not Trash).
+
+However, deleting the yearly albums by itself is not a reliable way to reclaim duplicate storage. If a duplicate copy is a separate uploaded file, "keep photos" just relocates it to Uncategorized, where it still takes up space.
+
+Recommended order:
+
+1. Run **Remove duplicates** first (`Settings > Backup > Free up space > Remove duplicates` on mobile, or `Settings > Free up space > Deduplicate files` on desktop). This safely merges the copies and frees the storage while keeping every album intact.
+2. Then, if you simply don't want the "Photos from 20XX" albums cluttering your album list, delete them with **Delete album, but keep photos**. Since the photos already exist in your original albums, they'll remain there safely.
+
### Why is my storage usage in Ente higher than what Google Photos showed? {#ente-storage-higher-than-google}
Google Photos and Ente count storage differently:
@@ -239,6 +264,31 @@ Now simply drag and drop the downloaded folders into [our desktop app](https://e
> Note: In case your uploads get interrupted, just drag and drop the folders into the same albums again, and we will ignore already backed up files and upload just the rest.
+### Why do Ente and Apple Photos show different item counts and storage usage for the same library? {#apple-photos-vs-ente-storage-mismatch}
+
+A gap between the two is expected, even right after a full import. It usually comes down to a few things:
+
+- **GB vs GiB**: Apple Photos calculates 1 GB as 1000 x 1000 x 1000 bytes, while Ente calculates 1 GB as 1024 x 1024 x 1024 bytes. The same library will always show as smaller in Ente. Learn more in [Why does Ente consume less storage than other providers?](/photos/faq/storage-and-plans#less-storage-usage)
+- **Items iOS excludes from third-party apps**: Some burst frames and certain shared or synced assets are excluded from third-party app queries by iOS itself, so Ente's on-device counts can be slightly lower than what Photos shows. See [Why is my Recents count lower in Ente than in the iOS Photos app?](/photos/faq/backup-and-sync#ios-recents-count-mismatch)
+- **The 10 GB file size limit**: Ente does not upload individual files larger than 10 GB.
+- **Skipped files**: Open `Albums > Device > Recents` (or whichever album is chosen for backup) and check for a "Skipped files" banner at the top, which lists any files that failed to back up and why.
+
+## Switching Devices
+
+### Will Ente recognize my existing backup if I switch phones? {#switch-phone-recognizes-backup}
+
+Yes. Your photos live in your Ente account, not on any single device. Install Ente on your new phone and sign in with the same account - your library downloads and syncs normally. New photos on your new phone are compared by content hash against what's already in your account, so anything already backed up won't be re-uploaded.
+
+### What affects how long a large migration takes? {#migration-speed-factors}
+
+A few factors determine migration speed for a large library:
+
+- **CPU and disk**: Every file is encrypted on your device and a thumbnail is generated before upload. On a fast connection, your device's CPU or disk can become the bottleneck instead of the network.
+- **File count vs size**: Lots of small photos carry more per-file overhead than a few large videos, so two libraries of the same total size can upload at very different speeds.
+- **Keep the device awake**: Disable sleep/hibernation (or auto-lock on mobile) so the upload doesn't stall overnight.
+
+For a typical home connection (20-50 Mbps upload speed), expect a large migration to take about a week.
+
## Importing from other cloud services
### I have photos on my phone and also photos autosynced from my phone to a cloud storage. How do I upload all these photos to Ente without duplicates? {#prevent-duplicates-cloud-sync}
diff --git a/docs/docs/photos/faq/sharing-and-collaboration.md b/docs/docs/photos/faq/sharing-and-collaboration.md
index 560ecf21bc..0705a0c18c 100644
--- a/docs/docs/photos/faq/sharing-and-collaboration.md
+++ b/docs/docs/photos/faq/sharing-and-collaboration.md
@@ -411,6 +411,12 @@ Open the album, create or manage the public link, and disable **Allow downloads*
This lets people view the album through the link without showing them a download option.
+### Why can't my public link be opened on mobile when downloads are disabled? {#public-link-download-disabled-mobile}
+
+This is intentional. When a public link has **Allow downloads** turned off, it cannot be opened on mobile browsers, since a mobile browser would otherwise let someone screenshot or save the photos anyway. This restriction is by design to keep the "no download" setting meaningful.
+
+The link continues to work normally on desktop and laptop browsers.
+
### Can I set limits on public links? {#link-limits}
Yes! Public links (including collect links) support several protective features:
diff --git a/docs/docs/photos/faq/troubleshooting.md b/docs/docs/photos/faq/troubleshooting.md
index c10f0bfcb5..81bef734aa 100644
--- a/docs/docs/photos/faq/troubleshooting.md
+++ b/docs/docs/photos/faq/troubleshooting.md
@@ -555,6 +555,20 @@ Disable your content blocker or add `photos.ente.com` to your allowlist. Wait 15
**Known issue with AdGuard:** AdGuard's basic filter blocks videos in Ente when using AdGuard Mini on Safari. This has been [reported to AdGuard filter developers](https://github.com/AdguardTeam/AdguardFilters/issues/216424).
+### Why do some of my videos stutter or freeze when I play them on iOS? {#ios-video-stutter-playback}
+
+This is an iOS-specific issue: for some videos, Apple Photos rejects the file and doesn't store it on your device, even though Ente backed it up successfully. Since the video isn't fully available locally, playback in the Ente app can stutter or freeze. The video itself is still safely stored in Ente - nothing is lost.
+
+Because this happens at the iOS level, there isn't much the app can do to prevent it directly. The workaround is to enable video streaming on desktop:
+
+1. Install Ente desktop from [ente.com/download/desktop](https://ente.com/download/desktop) and sign in with the same account.
+2. Open `Settings > Preferences` and enable **Streamable videos**.
+3. Leave the desktop app running - processing a large library can take time.
+
+As videos are processed, your iPhone automatically uses the streamable version for smooth playback, while your original file stays untouched.
+
+Learn more about [Video streaming](/photos/features/utilities/video-streaming).
+
## Performance Issues
### Why is the app slow to load my photos? {#app-slow-loading}
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 62066f0041..e4f0a07088 100644
--- a/docs/docs/photos/features/sharing-and-collaboration/public-links.md
+++ b/docs/docs/photos/features/sharing-and-collaboration/public-links.md
@@ -141,6 +141,10 @@ Disable the option to download original quality photos. Recipients can still vie
>
> This doesn't prevent screenshots or screen recording, but does make it harder for recipients to get high-quality copies.
+> [!NOTE]
+>
+> When downloads are disabled, the link cannot be opened on mobile browsers, since a mobile browser would otherwise let someone screenshot or save the photos anyway. It continues to work on desktop and laptop browsers.
+
### Allow joining album
Let people who open the link in their Ente app add the shared album to their account. This is handy when you want other Ente users to keep the album in their Shared tab without sending them individual invites.