From 6e31d6a3cd5c325bb36f2a7955fb2cb6f14fa90d Mon Sep 17 00:00:00 2001
From: Amanda <115730173+AmandaJ-W@users.noreply.github.com>
Date: Mon, 22 Jun 2026 11:40:58 +0200
Subject: [PATCH 1/5] Update managing_media_responses.md

---
 source/managing_media_responses.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/source/managing_media_responses.md b/source/managing_media_responses.md
index 030f99d24..63d28b9fb 100644
--- a/source/managing_media_responses.md
+++ b/source/managing_media_responses.md
@@ -144,3 +144,19 @@ To download media files using the DownThemAll extension:
 
 You can adjust the extension settings to limit download speed or retry failed downloads. This method can be used to download all media files, or only selected files, without relying on the ZIP export. 
 </details>
+
+<br>
+
+<details>
+  <summary><strong>Media URLs from older exports no longer work</strong></summary>
+Users who rely on media URLs from older Excel or CSV exports may notice that these links no longer work since <a href="https://support.kobotoolbox.org/migrating_api.html">API v1 was deprecated</a>.
+<br><br> 
+The affected URLs use the old format: 
+<code>https://kc.kobotoolbox.org/media/original?media_file=...</code>
+<br><br>
+To fix this issue, re-export your data with <strong>Include media URLs</strong> selected. The new export will include updated media URLs.
+<br><br>
+Advanced users can also recreate the export through <a href="https://support.kobotoolbox.org/synchronous_exports.html">synchronous exports</a> or rebuild URLs manually using the current API v2 format: 
+<code>https://kf.kobotoolbox.org/api/v2/assets/{asset_uid}/data/{submission_id}/attachments/{attachment_uid}/</code>
+</details>
+

From 00547c743692949a4d24624d17c4b9cca9e4f854 Mon Sep 17 00:00:00 2001
From: Amanda <115730173+AmandaJ-W@users.noreply.github.com>
Date: Mon, 22 Jun 2026 11:47:37 +0200
Subject: [PATCH 2/5] Update advanced_export.md

---
 source/advanced_export.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/source/advanced_export.md b/source/advanced_export.md
index d0f560e2e..981e23926 100644
--- a/source/advanced_export.md
+++ b/source/advanced_export.md
@@ -64,3 +64,16 @@ To use saved export settings, click on the dropdown menu under **Apply saved exp
 
 <br>
 
+<details>
+  <summary><strong>Media URLs from older exports no longer work</strong></summary>
+Users who rely on media URLs from older Excel or CSV exports may notice that these links no longer work since <a href="https://support.kobotoolbox.org/migrating_api.html">API v1 was deprecated</a>.
+<br><br> 
+The affected URLs use the old format: 
+<code>https://kc.kobotoolbox.org/media/original?media_file=...</code>
+<br><br>
+To fix this issue, re-export your data with <strong>Include media URLs</strong> selected. The new export will include updated media URLs.
+<br><br>
+Advanced users can also recreate the export through <a href="https://support.kobotoolbox.org/synchronous_exports.html">synchronous exports</a> or rebuild URLs manually using the current API v2 format: 
+<code>https://kf.kobotoolbox.org/api/v2/assets/{asset_uid}/data/{submission_id}/attachments/{attachment_uid}/</code>
+</details>
+

From 869b2c098e86d979f4406358ca6f9d62a2b9bc4b Mon Sep 17 00:00:00 2001
From: Amanda <115730173+AmandaJ-W@users.noreply.github.com>
Date: Mon, 22 Jun 2026 11:49:58 +0200
Subject: [PATCH 3/5] Update synchronous_exports.md

---
 source/synchronous_exports.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/source/synchronous_exports.md b/source/synchronous_exports.md
index 7cb942b52..0bd4c37e0 100644
--- a/source/synchronous_exports.md
+++ b/source/synchronous_exports.md
@@ -94,3 +94,18 @@ To maintain server reliability, synchronous exports have the following limitatio
 - **Data refresh interval:** Data in synchronous exports update every 5 minutes. Export requests made within this 5-minute window will not include new submission data received within the 5-minute interval.
 - **Export completion time:** Exports must complete within 120 seconds. Projects with a large number of submissions or questions may fail. To avoid this, add a query constraint in the export settings to limit submissions or filter out unnecessary questions. Refer to this [Community Forum post](https://community.kobotoolbox.org/t/how-to-download-data-between-two-dates-from-date-to-date/25569/4) for guidance.
 
+## Troubleshooting
+
+<details>
+  <summary><strong>Media URLs from older exports no longer work</strong></summary>
+Users who rely on media URLs from older Excel or CSV exports may notice that these links no longer work since <a href="https://support.kobotoolbox.org/migrating_api.html">API v1 was deprecated</a>.
+<br><br> 
+The affected URLs use the old format: 
+<code>https://kc.kobotoolbox.org/media/original?media_file=...</code>
+<br><br>
+To fix this issue, re-export your data with <strong>Include media URLs</strong> selected. The new export will include updated media URLs.
+<br><br>
+Advanced users can also recreate the export through <a href="https://support.kobotoolbox.org/synchronous_exports.html">synchronous exports</a> or rebuild URLs manually using the current API v2 format: 
+<code>https://kf.kobotoolbox.org/api/v2/assets/{asset_uid}/data/{submission_id}/attachments/{attachment_uid}/</code>
+</details>
+

From 57e7b25c8c93ed0954fdbf8b1f0445021c48d2c1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Salom=C3=A9=20Garnier?= <salomegarnier99@gmail.com>
Date: Mon, 22 Jun 2026 12:08:36 +0200
Subject: [PATCH 4/5] Remove advanced export instructions

Removed instructions for advanced users on recreating exports and rebuilding URLs manually.
---
 source/advanced_export.md | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/source/advanced_export.md b/source/advanced_export.md
index 981e23926..e1eaf0958 100644
--- a/source/advanced_export.md
+++ b/source/advanced_export.md
@@ -72,8 +72,5 @@ The affected URLs use the old format:
 <code>https://kc.kobotoolbox.org/media/original?media_file=...</code>
 <br><br>
 To fix this issue, re-export your data with <strong>Include media URLs</strong> selected. The new export will include updated media URLs.
-<br><br>
-Advanced users can also recreate the export through <a href="https://support.kobotoolbox.org/synchronous_exports.html">synchronous exports</a> or rebuild URLs manually using the current API v2 format: 
-<code>https://kf.kobotoolbox.org/api/v2/assets/{asset_uid}/data/{submission_id}/attachments/{attachment_uid}/</code>
 </details>
 

From a9ffb6981f068a3e284874f3d521a554abfc2b86 Mon Sep 17 00:00:00 2001
From: Amanda <115730173+AmandaJ-W@users.noreply.github.com>
Date: Mon, 22 Jun 2026 12:22:20 +0200
Subject: [PATCH 5/5] Update synchronous_exports.md

---
 source/synchronous_exports.md | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/source/synchronous_exports.md b/source/synchronous_exports.md
index 0bd4c37e0..51dfb19bd 100644
--- a/source/synchronous_exports.md
+++ b/source/synchronous_exports.md
@@ -98,14 +98,10 @@ To maintain server reliability, synchronous exports have the following limitatio
 
 <details>
   <summary><strong>Media URLs from older exports no longer work</strong></summary>
-Users who rely on media URLs from older Excel or CSV exports may notice that these links no longer work since <a href="https://support.kobotoolbox.org/migrating_api.html">API v1 was deprecated</a>.
+Users who rely on media URLs from older synchronous exports may notice that these links no longer work since <a href="https://support.kobotoolbox.org/migrating_api.html">API v1 was deprecated</a>.
 <br><br> 
 The affected URLs use the old format: 
 <code>https://kc.kobotoolbox.org/media/original?media_file=...</code>
 <br><br>
-To fix this issue, re-export your data with <strong>Include media URLs</strong> selected. The new export will include updated media URLs.
-<br><br>
-Advanced users can also recreate the export through <a href="https://support.kobotoolbox.org/synchronous_exports.html">synchronous exports</a> or rebuild URLs manually using the current API v2 format: 
-<code>https://kf.kobotoolbox.org/api/v2/assets/{asset_uid}/data/{submission_id}/attachments/{attachment_uid}/</code>
+To fix this issue, re-create your synchronous exports with <strong>Include media URLs</strong> selected. The new export will include updated media URLs.
 </details>
-