Skip to content

Update-troubleshooting-sections #555

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
salomegarnier merged 5 commits into from
Jun 22, 2026
Merged

Update-troubleshooting-sections #555

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
6e31d6a
Update managing_media_responses.md
AmandaJ-W Jun 22, 2026
00547c7
Update advanced_export.md
AmandaJ-W Jun 22, 2026
869b2c0
Update synchronous_exports.md
AmandaJ-W Jun 22, 2026
57e7b25
Remove advanced export instructions
salomegarnier Jun 22, 2026
a9ffb69
Update synchronous_exports.md
AmandaJ-W Jun 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions source/advanced_export.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,3 +64,13 @@ 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.
</details>

16 changes: 16 additions & 0 deletions source/managing_media_responses.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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>

11 changes: 11 additions & 0 deletions source/synchronous_exports.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -94,3 +94,14 @@ 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 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-create your synchronous exports with <strong>Include media URLs</strong> selected. The new export will include updated media URLs.
</details>
Loading