From e49c0df561fcc94495757570b2c86aac93e4fa42 Mon Sep 17 00:00:00 2001
From: Sangeet Mishra <143380171+SangeetaMishr@users.noreply.github.com>
Date: Wed, 3 Jun 2026 12:01:04 +0530
Subject: [PATCH] Enhance FAQ on Google Sheet sync failure errors
Added detailed error handling information for Google Sheet sync failures, including media validation criteria and requirements.
---
.../Why is the google sheet sync failing.md | 39 +++++++++++++++++++
1 file changed, 39 insertions(+)
diff --git a/docs/8. FAQ/Why is the google sheet sync failing.md b/docs/8. FAQ/Why is the google sheet sync failing.md
index 5fd995132..a4b52df83 100644
--- a/docs/8. FAQ/Why is the google sheet sync failing.md
+++ b/docs/8. FAQ/Why is the google sheet sync failing.md
@@ -1,3 +1,16 @@
+
+
+
+ | 5 minutes read |
+ Level: Intermediate |
+ Last Updated: June 2026 |
+
+
+
+
+
+
+
# Why is the Google Sheet sync failing?
Google sheets on read mode with auto-sync functionality turned on sync once in every 24 hours. The sync operations happens around 5-6 am IST. If google sheet fails to sync, there is an error condition that is displayed on the google sheets page.
@@ -32,4 +45,30 @@ This condition happens when there are headers which are repeated, or if there ar
To solve this, make sure that the headers have unique names. Also, ensure that all columns where content is present have a named header.
+## 6. Media Validation Failed
+
+This error occurs when one or more media URLs provided in the Google Sheet do not meet the required validation criteria.
+
+
+
+
+Ensure that all media URLs added in the sheet:
+
+- Are valid, non-empty URLs (URI).
+- Return a successful HTTP response (2xx status code) within 10 seconds.
+- Have a content type that matches the file extension:
+ - Images → image/*
+ - Videos → video/*
+ - Audio → audio/*
+ - Documents → application/*
+ - Stickers → image/webp
+
+- Are within the supported file size limits:
+
+ - Images: Up to 5 MB
+ - Videos: Up to 16 MB
+ - Audio: Up to 16 MB
+ - Documents: Up to 100 MB
+ - Stickers: Up to 100 KB
+To solve this review the media URLs in the Google Sheet and ensure they satisfy all the above requirements. Update any invalid, inaccessible, incorrectly formatted, or oversized media files before retrying the import.