Skip to content

armgit / ente

Public Imported from GitHub
0

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

[Docs] Clarify Photos and Locker help guidance (#13872)

Shanthy712dd17c7730
diff --git a/docs/docs/locker/faq/information-types.md b/docs/docs/locker/faq/information-types.md
index 953a414b6f..2c28da2d41 100644
--- a/docs/docs/locker/faq/information-types.md
+++ b/docs/docs/locker/faq/information-types.md
@@ -56,6 +56,8 @@ 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.
+If a large file fails to upload in Locker on mobile, try uploading it with Locker web on locker.ente.com. Larger uploads can fail on mobile because multipart uploads are not generally enabled there. For a self-hosted account, use the Locker web client connected to your own server.
+
### How do I add a photo or image to Locker on iOS? {#locker-add-image-ios}
**On iOS:**
diff --git a/docs/docs/locker/features/information-types/account-credentials.md b/docs/docs/locker/features/information-types/account-credentials.md
index b02c032828..18a7b48b36 100644
--- a/docs/docs/locker/features/information-types/account-credentials.md
+++ b/docs/docs/locker/features/information-types/account-credentials.md
@@ -10,8 +10,8 @@ Secrets let you securely store login information for websites and services. Keep
## What you can store
- **Name**: A recognizable name for the account (e.g., "Gmail", "Bank Account")
-- **Username**: Your login identifier (username or email)
-- **Password**: Your account password
+- **Username**: Your login identifier (username or email), optional
+- **Password**: Your account password, optional
- **Notes**: Additional information about the account (optional)
## Creating a secret
@@ -29,8 +29,8 @@ Secrets let you securely store login information for websites and services. Keep
3. Select **Secret**
4. Fill in the fields:
- **Name**: A recognizable name (e.g., "Gmail", "Bank Account")
- - **Username**: Your username or email for the account
- - **Password**: Your password
+ - **Username**: Your username or email for the account (optional)
+ - **Password**: Your password (optional)
- **Notes**: Any additional details (optional)
5. Select one or more collections
6. Tap **Save**
diff --git a/docs/docs/locker/features/information-types/personal-notes.md b/docs/docs/locker/features/information-types/personal-notes.md
index a86ba6d1ca..8ae8d6205c 100644
--- a/docs/docs/locker/features/information-types/personal-notes.md
+++ b/docs/docs/locker/features/information-types/personal-notes.md
@@ -29,8 +29,8 @@ Notes let you store any text securely with end-to-end encryption. Use them for s
1. Open Ente Locker
2. Tap the **+** button
3. Select **Note**
-4. Enter a title for your note
-5. Write your note content in the text field
+4. Write your note content in the text field
+5. Add a title if you want. If you leave it blank, Locker generates one from the content
6. Select one or more collections
7. Tap **Save**
diff --git a/docs/docs/locker/features/information-types/physical-records.md b/docs/docs/locker/features/information-types/physical-records.md
index 8d51f9b0f1..d13f5456fb 100644
--- a/docs/docs/locker/features/information-types/physical-records.md
+++ b/docs/docs/locker/features/information-types/physical-records.md
@@ -33,7 +33,7 @@ Things help you remember where important physical documents are stored. Track th
3. Select **Thing**
4. Fill in the fields:
- **Name**: Document name (e.g., "Passport", "House Deed")
- - **Location**: Where it's stored (e.g., "Home safe, top drawer")
+ - **Location**: Where it's stored (e.g., "Home safe, top drawer"), optional
- **Notes**: Any other relevant information (optional)
5. Select one or more collections
6. Tap **Save**
diff --git a/docs/docs/locker/getting-started/first-document.md b/docs/docs/locker/getting-started/first-document.md
index 60272a9b9e..f4f2fff27f 100644
--- a/docs/docs/locker/getting-started/first-document.md
+++ b/docs/docs/locker/getting-started/first-document.md
@@ -57,8 +57,8 @@ Document scanning is available in the Locker mobile app on Android and iOS.
2. Select **Secret**
3. Fill in the fields:
- **Name**: A name for this entry (e.g., "Bank Account")
- - **Username**: Your username or email
- - **Password**: Your password
+ - **Username**: Your username or email (optional)
+ - **Password**: Your password (optional)
- **Notes**: Any additional information (optional)
4. Leave collections unselected to use **Uncategorized**. Or select one or more collections to organize this item
5. Tap **Save**
diff --git a/docs/docs/photos/faq/backup-and-sync.md b/docs/docs/photos/faq/backup-and-sync.md
index 5fb55a68ba..f9f852204e 100644
--- a/docs/docs/photos/faq/backup-and-sync.md
+++ b/docs/docs/photos/faq/backup-and-sync.md
@@ -63,7 +63,7 @@ Yes. You can enable this during signup/login on the permissions screen, or later
- **During onboarding**: Ente backs up from the **last 7 days** onward, so you have some recent photos available right away.
- **Via the settings toggle**: Ente uses the current moment as the cutoff - only photos taken from that point forward are backed up.
-In both cases, photos older than the cutoff will not be uploaded to Ente.
+The cutoff applies when Ente selects photos for automatic backup. Turning it on does not cancel uploads already queued, and manually selected older photos can still be uploaded.
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.
@@ -71,6 +71,10 @@ 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.
+### Does a restarting Backup mode counter mean my library is uploading again? {#backup-mode-counter-restarts}
+
+No. Backup mode progress relates to the current upload session. The counter can restart when a new session begins. A reset alone does not mean your entire library is uploading again. Check [Backup status](#check-backup-status) for pending items.
+
### Can I backup over mobile data or only WiFi? {#mobile-data}
By default, Ente only backs up photos over WiFi to save mobile data and battery. However, you can change this setting:
@@ -220,6 +224,8 @@ Ente supports all files with mime types of `image/*` or `video/*`, regardless of
- Maximum file size: 10 GB
- Some video formats cannot be streamed on web browsers and must be downloaded
+Backup support and preview support can differ. A JPEG XL original may upload while its thumbnail or in-app preview is unavailable, including on Linux desktop. A missing preview alone does not tell you whether the original uploaded. Check [Backup status](#check-backup-status), and download the original if you need to verify it.
+
### Does Ente compress my photos during backup? {#does-ente-compress}
No. Ente backs up your photos in **original quality with no compression**. The file size of your photos in Ente will be the same as the original file sizes.
@@ -384,15 +390,17 @@ If Ente isn't picking these up:
### Can I pick photos from Ente in other apps? {#pick-photos-in-other-apps}
-On supported Android apps, yes. If an app (such as WhatsApp) opens the system photo picker, you can choose Ente Photos as the source and select photos or videos from your Ente library.
+In some Android apps, yes. If an app offers Ente Photos in its app chooser or under **Browse**, select it to open Ente's own picker and choose photos or videos from your Ente library.
A few details to keep in mind:
-- This works through Android's picker integration, so it depends on the third-party app using the standard picker flow.
+- The option depends on the third-party app's picker flow and may not appear in every app.
- Ente returns the files you select to that app for sending or attaching.
-- The picker shows the photos and videos available in your Ente gallery on that device.
+- A cloud-only item may need to download before Ente can return it. Ente can reuse a cached copy.
- On iPhone, iOS does not currently let Ente plug into other apps' photo pickers in the same way.
+This opens Ente's picker. It does not add your Ente cloud library as a source inside Android's system Photo Picker. See the [cloud media provider answer](#android-cloud-media-provider).
+
### 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).
@@ -835,6 +843,8 @@ Ente supports all files that have a mime type of `image/*` or `video/*` regardle
However, we only have limited support for RAW currently. We are working towards adding full support, and you can watch this [thread](https://github.com/ente/ente/discussions/625) for updates.
+Backup support and viewing support can differ. For example, JPEG XL files may upload even when Ente cannot show a thumbnail or preview. Check [Backup status](#check-backup-status) rather than treating a missing preview as proof that the original failed to upload.
+
If you find an issue with ente's ability to parse a certain file type, please write to [[email protected]](mailto:[email protected]) with details of the unsupported file format and we will do our best to help you out.
### Is there a file size limit? {#file-size-limit}
diff --git a/docs/docs/photos/faq/metadata-and-editing.md b/docs/docs/photos/faq/metadata-and-editing.md
index 196f249567..129c29b949 100644
--- a/docs/docs/photos/faq/metadata-and-editing.md
+++ b/docs/docs/photos/faq/metadata-and-editing.md
@@ -379,7 +379,7 @@ We're working on bringing all editing features to all platforms.
### A photo I shared into Ente from WhatsApp shows the wrong date in the timeline. Why? {#whatsapp-wrong-date}
-Apps like WhatsApp strip the hidden "date taken" information from photos for privacy. When Ente can't find that information, and can't reliably extract it from the filename either (especially for videos), it falls back to the upload date.
+The timeline date can depend on how the file reaches Ente. On Android, a video shared directly into Ente may use a date from its filename, or the time you imported it, rather than its embedded capture date. This does not by itself show that the sending app removed metadata.
To fix dates already uploaded, the easiest path is the desktop app, which supports bulk editing:
diff --git a/docs/docs/photos/faq/search-and-discovery.md b/docs/docs/photos/faq/search-and-discovery.md
index 1264a8b06e..9a7e0f598c 100644
--- a/docs/docs/photos/faq/search-and-discovery.md
+++ b/docs/docs/photos/faq/search-and-discovery.md
@@ -5,6 +5,14 @@ description: Frequently asked questions about finding photos using map, face rec
# Search and Discovery
+## General Search
+
+### How do I view only photos, videos or Live Photos? {#filter-by-file-type}
+
+On mobile, open **Search** and scroll to **File types**. Select **Photos**, **Videos**, or **Live** to view that type. You can also select a file extension, such as **JPG** or **MP4**.
+
+These shortcuts search your library. They do not change an album's contents.
+
## Map View
### Why doesn't the map show all my photos? {#missing-photos}
diff --git a/docs/docs/photos/faq/security-and-privacy.md b/docs/docs/photos/faq/security-and-privacy.md
index 5cef1b2afc..c1af86b624 100644
--- a/docs/docs/photos/faq/security-and-privacy.md
+++ b/docs/docs/photos/faq/security-and-privacy.md
@@ -51,13 +51,13 @@ If you are logged into Ente on any of your existing devices, you can use that de
If you are logged out of Ente on all your devices, you can reset your password using your recovery key that was provided to you during account creation.
-If you are logged out of Ente on all your devices and you have lost both your password and recovery key, we cannot recover your account or data due to our end-to-end encrypted architecture.
+If you are logged out of Ente on all your devices and have lost both your password and recovery key, Ente support cannot recover your account or data due to end-to-end encryption. A previously accepted [Legacy trusted contact](/photos/features/account/legacy/) may be able to recover your account after the configured waiting period, unless recovery is blocked. You cannot set up this route after losing access.
If you wish to delete your account in such scenarios, please reach out to [email protected] and we will help you out.
### What is my recovery key and why is it critical? {#recovery-key-importance}
-Your **recovery key is a 24-word phrase** that is the ONLY way to recover your account if you:
+Your **recovery key is a 24-word phrase** used to recover your account if you:
- Forget your password AND
- Are logged out of all devices
@@ -66,7 +66,7 @@ Your **recovery key is a 24-word phrase** that is the ONLY way to recover your a
⚠️ **Ente support CANNOT provide or regenerate your recovery key**. Due to end-to-end encryption, we never have access to your recovery key or your encrypted data.
-⚠️ **Without your recovery key, losing your password means permanently losing access** to all your photos if you're logged out everywhere.
+⚠️ **Without your recovery key, losing your password means permanently losing access** to your photos if you're logged out everywhere and have no previously accepted [Legacy trusted contact](/photos/features/account/legacy/).
⚠️ **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.
diff --git a/docs/docs/photos/faq/storage-and-plans.md b/docs/docs/photos/faq/storage-and-plans.md
index 7db5c06361..f4a8248b97 100644
--- a/docs/docs/photos/faq/storage-and-plans.md
+++ b/docs/docs/photos/faq/storage-and-plans.md
@@ -17,6 +17,8 @@ We decided to leave out the **i** from **GiBs** to reduce noise on our interface
This means that the same file appears to take up less "storage" on Ente compared to providers using GB (base-1000) calculation.
+Storage usage in the mobile app is rounded for display, so a small upload may not visibly change the total. To check pending uploads, see [Backup status](/photos/faq/backup-and-sync#check-backup-status).
+
### How does Ente deduplicate photos? {#deduplication}
Ente automatically detects and handles duplicate files during backup to save storage space:
diff --git a/docs/docs/photos/features/account/legacy/index.md b/docs/docs/photos/features/account/legacy/index.md
index 288460bbc9..6b24041eb5 100644
--- a/docs/docs/photos/features/account/legacy/index.md
+++ b/docs/docs/photos/features/account/legacy/index.md
@@ -11,7 +11,7 @@ Trusted Contacts can initiate a recovery, and if not blocked within the chosen w
## Adding a trusted contact
-You can add a trusted contact for your account using the mobile app for Ente Photos. Open `Settings > Account > Legacy`, and click on "Add Trusted Contact".
+You can add a trusted contact for your account using the Ente Photos mobile app. Open `Settings > Legacy` and tap **Add Trusted Contact**.
You would be asked to enter the email address of the trusted contact you want to add or choose from a list of contacts on Ente. Please note that the trusted contact must be an Ente user.
@@ -21,7 +21,7 @@ You would be asked to enter the email address of the trusted contact you want to
</div>
-The trusted contact must accept your request. They can do so by going to Settings -> Account -> Legacy in the Ente Photos mobile app, and clicking on your email address within the Legacy accounts sections. Ente would also send an email notification to the trusted contact to nudge them to accept the invite.
+The trusted contact must accept your request. They can open `Settings > Legacy` in the Ente Photos mobile app and tap your account in the Legacy section. Ente also sends them an email notification about the request.
<div align="center">
@@ -31,7 +31,7 @@ The trusted contact must accept your request. They can do so by going to Setting
## Recovering an account as a trusted contact
-As a trusted contact, you can recover an account by going to Settings -> Account -> Legacy in the Ente photos app, tapping on the email address of the account within the Legacy account sections.
+As a trusted contact, open `Settings > Legacy` in the Ente Photos mobile app and tap the account you want to recover.
<div align="center">
@@ -43,8 +43,8 @@ Once the recovery is initiated, the account owner would get 7, 14, or 30 days (a
## Blocking account recovery by a trusted contact
-After a trusted contact initiates a recover, you, as the account owner, would get 7, 14, or 30 days (as configured) to block the recovery. To do this, you must go to `Settings > Account > Legacy`, where you will see a message that recovery of the account has been initiated. Tapping on that will allow you to block the recovery.
+After a trusted contact starts recovery, you have 7, 14, or 30 days (as configured) to block it. Open `Settings > Legacy` in the Ente Photos mobile app and tap the recovery notice to block it.
## Removing a trusted contact
-You can remove a trusted contact by going to `Settings > Account > Legacy`, tapping on the trusted contact you want to remove, and choosing "Remove" in the popup.
+Open `Settings > Legacy` in the Ente Photos mobile app, tap the trusted contact, and select **Remove**.
diff --git a/docs/docs/photos/features/albums-and-organization/albums.md b/docs/docs/photos/features/albums-and-organization/albums.md
index 7c066301b2..a1cdac528e 100644
--- a/docs/docs/photos/features/albums-and-organization/albums.md
+++ b/docs/docs/photos/features/albums-and-organization/albums.md
@@ -217,6 +217,8 @@ If you have multiple empty albums cluttering your album list, you can bulk delet
This will delete all empty albums from your library. The feature only appears after your initial sync is complete and when you have more than 2 empty albums.
+Bulk-deleting empty Ente albums does not turn off backup for their device folders. If a selected folder contains media eligible for backup, Ente can create its album again. Open `Settings > Backup > Backed up folders` and turn off a folder only if you also want to stop its automatic backup.
+
**On web / desktop:**
1. Open **All Albums**
diff --git a/docs/docs/photos/features/albums-and-organization/archive.md b/docs/docs/photos/features/albums-and-organization/archive.md
index f9270d3c96..3a2ff86cff 100644
--- a/docs/docs/photos/features/albums-and-organization/archive.md
+++ b/docs/docs/photos/features/albums-and-organization/archive.md
@@ -44,11 +44,9 @@ You can remove a photo (owned by you) or an album from your **home timeline** by
**On web/desktop:**
-- Click the menu icon (three horizontal lines) at top left
+- Open **Albums**
- Select **Archive**
-![Archive item in the sidebar menu on Ente Photos web](https://docs-assets.ente.com/screenshots/web-archive-sidebar.png){width=720px}
-
![Archive view showing archived albums and photos on Ente Photos web](https://docs-assets.ente.com/screenshots/web-archive-view.png){width=720px}
### Metadata Privacy
diff --git a/docs/docs/photos/features/albums-and-organization/deleting.md b/docs/docs/photos/features/albums-and-organization/deleting.md
index 4dd312e62c..2d2587b4ec 100644
--- a/docs/docs/photos/features/albums-and-organization/deleting.md
+++ b/docs/docs/photos/features/albums-and-organization/deleting.md
@@ -94,10 +94,8 @@ Trash is a special folder where deleted photos are held temporarily before perma
**On web/desktop:**
-1. Open the sidebar menu
-2. Click on "Trash"
-
-![Trash item in the sidebar menu on Ente Photos web](https://docs-assets.ente.com/screenshots/web-trash-sidebar.png){width=720px}
+1. Open **Albums**
+2. Select **Trash**
![Trash view showing deleted photos on Ente Photos web](https://docs-assets.ente.com/screenshots/web-trash-view.png){width=720px}
diff --git a/docs/docs/photos/features/albums-and-organization/hide.md b/docs/docs/photos/features/albums-and-organization/hide.md
index b02b83f715..912f267366 100644
--- a/docs/docs/photos/features/albums-and-organization/hide.md
+++ b/docs/docs/photos/features/albums-and-organization/hide.md
@@ -47,12 +47,10 @@ Hiding differs from [Archiving](./archive) in that hidden content won't appear a
**On web/desktop:**
-- Click the menu icon (three horizontal lines) at top left
+- Open **Albums**
- Select **Hidden**
- Authenticate with your Ente password
-![Hidden item in the sidebar menu on Ente Photos web](https://docs-assets.ente.com/screenshots/web-hidden-sidebar.png){width=720px}
-
![Password authentication dialog for Hidden on Ente Photos web](https://docs-assets.ente.com/screenshots/web-hidden-auth.png){width=720px}
![Hidden view showing hidden albums and photos on Ente Photos web](https://docs-assets.ente.com/screenshots/web-hidden-view.png){width=720px}
diff --git a/docs/docs/photos/features/backup-and-sync/index.md b/docs/docs/photos/features/backup-and-sync/index.md
index 8a6fd3f4ea..2722b05917 100644
--- a/docs/docs/photos/features/backup-and-sync/index.md
+++ b/docs/docs/photos/features/backup-and-sync/index.md
@@ -66,6 +66,8 @@ To use Backup mode:
You only need Backup mode for large uploads. New photos will continue to back up in the background afterwards.
+The progress shown during Backup mode relates to the current upload session. It may restart when a new session begins. A reset counter alone does not mean your entire library is uploading again.
+
Large videos may not finish during the short time iOS gives Ente in the background. Ente will continue the upload when iOS gives it more time or when you open the app.
Do not swipe Ente away from the app switcher. iOS cannot wake Ente for a background backup after the app has been closed this way.
@@ -125,7 +127,7 @@ When you select this option during onboarding, Ente backs up photos from the **l
When you enable the toggle in settings after onboarding, Ente uses the **current moment** as the cutoff - only photos created from that point forward will be backed up.
-In both cases, photos older than the cutoff date on your device will not be uploaded.
+The cutoff applies when Ente selects photos for automatic backup. Turning it on does not cancel uploads already queued. You can also manually select older photos to upload.
### Folder selection prompt
diff --git a/docs/docs/photos/features/search-and-discovery/index.md b/docs/docs/photos/features/search-and-discovery/index.md
index 6aaeef6dcc..c6a2a20e1c 100644
--- a/docs/docs/photos/features/search-and-discovery/index.md
+++ b/docs/docs/photos/features/search-and-discovery/index.md
@@ -16,7 +16,9 @@ You can quickly access search using the keyboard shortcut:
- **Windows/Linux**: `Ctrl + K`
- **Mac**: `Cmd + K`
-This focuses the search bar from anywhere in the app, letting you start searching immediately.
+Close Settings before using this shortcut. It does not open search while Settings is displayed.
+
+On mobile, open **Search** and scroll to **File types** to find **Photos**, **Videos**, **Live**, and file extensions such as **JPG** or **MP4**. These shortcuts search your library; they do not change an album's contents.
### Date search {#date-search}
diff --git a/docs/docs/photos/features/utilities/android-gallery.md b/docs/docs/photos/features/utilities/android-gallery.md
index 4d2e9bb0be..495063bd1a 100644
--- a/docs/docs/photos/features/utilities/android-gallery.md
+++ b/docs/docs/photos/features/utilities/android-gallery.md
@@ -13,7 +13,7 @@ On Android, Ente integrates with the rest of the system so it can act like a reg
## Pick photos and videos from Ente in other apps
-When another app asks you to attach a photo or video β€” for example a messenger, an email client, or a social app β€” Ente shows up as one of the apps you can pick from.
+When another app asks you to attach a photo or video, it may offer Ente Photos in an app chooser or under **Browse**. This depends on the other app's picker flow.
**How it works:**
@@ -26,9 +26,11 @@ When another app asks you to attach a photo or video β€” for example a messenger
The picker opens directly in Ente without interrupting your normal session, and the original app receives the files you selected.
+This opens Ente's own picker. It does not add your Ente cloud library as a source inside Android's system Photo Picker. A cloud-only item may need to download before Ente can return it; Ente can reuse a cached copy. Learn more in the [picker FAQ](/photos/faq/backup-and-sync#pick-photos-in-other-apps).
+
Ente registers as a handler for the standard Android picker intents, so it works with:
-- The system photo picker (`PICK_IMAGES`)
+- Apps that send the `PICK_IMAGES` intent and offer Ente through an app chooser or **Browse** option
- Apps that use `PICK` or `GET_CONTENT` to request media
- Both single-item and multi-item selection
- Image-only, video-only, or mixed media requests