Skip to content

armgit / ente

Public Imported from GitHub
0

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

[Docs] Add watched-folder rename recovery FAQ (#14112)

Shanthy1af0a1424d8d
diff --git a/docs/docs/photos/faq/backup-and-sync.md b/docs/docs/photos/faq/backup-and-sync.md
index f9f852204e..8faeb9039f 100644
--- a/docs/docs/photos/faq/backup-and-sync.md
+++ b/docs/docs/photos/faq/backup-and-sync.md
@@ -614,6 +614,28 @@ Ente treats a renamed file as a deleted file plus a new one. The new file is upl
You can review and delete those copies in Uncategorized.
+### Why are my albums empty after I renamed a folder inside a watched folder? {#rename-folder-in-watched-folder}
+
+When you rename a folder inside a watched folder, the desktop app sees every file in it as deleted and added again. This can remove the photos from their albums and move them to [Uncategorized](/photos/faq/albums-and-organization#uncategorized). Your photos are not deleted.
+
+Do not rename the folder back. That repeats the same process. You can keep the new name.
+
+To restore the photos to albums:
+
+1. Open the desktop app and click **Watch folders** in the sidebar.
+2. Click the **Stop watching** button next to the main watched folder, then **Yes, stop**. This does not delete any photos from Ente.
+3. Click **Add folder** and select the same main folder again.
+4. Choose the same option you used before, for example **Separate albums**.
+5. Wait for the sync to finish.
+
+Ente checks for photos it has already uploaded. When it recognizes a match, it adds the photo to an album without uploading the file again. If you renamed a photo in Ente, it may upload again because its name no longer matches the file on your computer.
+
+With **Separate albums**, each photo goes into an album named after its immediate parent folder. If the renamed folder directly contains photos, they appear in a new album with that folder's new name. The old album is not refilled by those photos. Photos in deeper subfolders can return to their existing albums. Check where the photos appear before deleting any empty album.
+
+To remove leftover entries, open Uncategorized and select the clean icon (broom). This removes only items that are also in another album. Review anything left in Uncategorized before deleting it.
+
+To avoid this next time, stop watching the main folder before you rename a folder inside it, then add the main folder again.
+
### Why are my watch folders not syncing? {#watch-folders-not-syncing}
Common issues and solutions:
@@ -648,8 +670,8 @@ While the app may work with network drives in some cases, we've found that netwo
1. Click "Watch folders" in the sidebar
2. Find the folder you want to stop watching
-3. Click the three dots next to that folder entry
-4. Select "Stop watching"
+3. Click the **Stop watching** button next to that folder entry
+4. Confirm with **Yes, stop**
The folder will no longer be monitored, but all files that were already uploaded to Ente will remain there. Stopping watch does not delete any photos from Ente.
diff --git a/docs/docs/photos/faq/index.md b/docs/docs/photos/faq/index.md
index 63a405646d..0697dcc7ae 100644
--- a/docs/docs/photos/faq/index.md
+++ b/docs/docs/photos/faq/index.md
@@ -163,6 +163,7 @@ Jump to a category:
- [What happens if I delete a file from my watched folder?](/photos/faq/backup-and-sync#delete-from-watched-folder)
- [Why don't metadata changes to a file in my watched folder show up in Ente?](/photos/faq/backup-and-sync#watch-folder-edited-files)
- [What happens if I rename a file in my watched folder?](/photos/faq/backup-and-sync#rename-in-watched-folder)
+- [Why are my albums empty after I renamed a folder inside a watched folder?](/photos/faq/backup-and-sync#rename-folder-in-watched-folder)
- [Why are my watch folders not syncing?](/photos/faq/backup-and-sync#watch-folders-not-syncing)
- [Can I watch folders on a network drive (NAS)?](/photos/faq/backup-and-sync#watch-nas)
- [How do I stop watching a folder?](/photos/faq/backup-and-sync#stop-watching-folder)
diff --git a/docs/docs/photos/features/backup-and-sync/watch-folders.md b/docs/docs/photos/features/backup-and-sync/watch-folders.md
index 3b04511c28..8b2007df24 100644
--- a/docs/docs/photos/features/backup-and-sync/watch-folders.md
+++ b/docs/docs/photos/features/backup-and-sync/watch-folders.md
@@ -24,7 +24,7 @@ Paired with the option to run Ente automatically when your computer starts, this
5. When the app is syncing in the background it'll show a small progress status in the bottom right. You can expand it to see more details if needed.
-6. You can stop watching any folder by clicking on the three dots next to the watch folder entry, and then selecting **Stop watching**.
+6. You can stop watching any folder by clicking the **Stop watching** button next to the watch folder entry, then confirming with **Yes, stop**.
> Note: In case you start a new upload while an existing sync is in progress, the sync will be paused then and resumed when your upload is done.