Skip to content

Sheet sync fails info #534

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
SangeetaMishr merged 6 commits into from
Dec 26, 2025
Merged

Sheet sync fails info #534

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
50706fc
Add FAQ on Google Sheets sync failures
mahajantejas Dec 24, 2025
4cf4373
Added content on sheet sync in the google sheets main page, under the…
mahajantejas Dec 24, 2025
230a36d
Update last updated date to December 2025
mahajantejas Dec 24, 2025
35195db
Update docs/4. Product Features/03. Flows/2. Flow Actions/12. Link Go…
mahajantejas Dec 24, 2025
208948c
Update docs/8. FAQ/Why is the google sheet sync failing.md
mahajantejas Dec 24, 2025
4613999
Update docs/8. FAQ/Why is the google sheet sync failing.md
mahajantejas Dec 24, 2025
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: 9 additions & 1 deletion docs/4. Product Features/03. Flows/2. Flow Actions/12. Link Google Sheets.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ ___
<tr>
<td><b>15 minutes read</b></td>
<td style={{ paddingLeft: '40px' }}><b>Level: Intermediate</b></td>
<td style={{ paddingLeft: '40px' }}><b>Last Updated: October 2025</b></td>
<td style={{ paddingLeft: '40px' }}><b>Last Updated: December 2025</b></td>
</tr>
</table>
</h3>
Expand Down Expand Up @@ -68,6 +68,14 @@ ___

- Dynamic Menu: Read items from a sheet and send them as interactive list options.

### Google Sheet Sync

- When content to a linked google sheet in read mode is updated, the sheet needs to be `synced` using the sync button corresponding to the google sheet.
- This ensures that the latest modifications made in the google sheet are available to use in the Glific flows where the sheet is being used.
- Google sheet in read-mode and on auto-sync functionality sync every 24 hours. The google sync operations happen between 5-6am IST
- To handle use case which demand that the google sheets be synced more than once a day or as per a custom logic, read more [here](https://docs.google.com/document/d/1Hix2ShKMJqfhOHrTc4GAT2JWc3ThyuZ8RvdO61wc2d4/edit?usp=sharing)
- If the google sheet fails to sync, the flow continues to send older content.
- To troubleshoot sheet sync failure errors, read more in FAQ section.

### Why to use Write Mode of Google Sheet

Expand Down
35 changes: 35 additions & 0 deletions docs/8. FAQ/Why is the google sheet sync failing.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# 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.
Copy link
Contributor

@coderabbitai coderabbitai bot Dec 24, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Capitalize "Google" and "Google Drive" throughout the document.

Several instances of lowercase "google" should be capitalized as "Google" (a proper noun). Additionally, line 24 should use "Google Drive" (the official product name) instead of "google drive". Line 3 also contains a grammar issue: "happens" should be "happen" (plural subject).

🔎 Proposed fixes 
-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.
+Google Sheets on read mode with auto-sync functionality turned on sync once in every 24 hours. The sync operations happen around 5-6 am IST. If the Google Sheet fails to sync, there is an error condition that is displayed on the Google Sheets page.
-This document details out the error conditions that make the google sheets sync to fail, and how to solve these situations are explained below.
+This document details the error conditions that make the Google Sheets sync fail, and how to solve these situations.
-This happens if the sheet permissions are not in order. To use "read from google sheet" capability, the google sheet being used should have "anyone with the link" can "view" permission.
+This happens if the sheet permissions are not in order. To use "read from Google Sheet" capability, the Google Sheet being used should have "anyone with the link" can "view" permission.
-This condition could also occur in case the sheet is deleted from the google drive.
+This condition could also occur in case the sheet is deleted from Google Drive.

Also applies to: 5-5, 22-22, 24-24

🧰 Tools
🪛 LanguageTool

[uncategorized] ~3-~3: “Google” is a proper noun and needs to be capitalized.
Context: ...rror condition that is displayed on the google sheets page. This document details ou...

(A_GOOGLE)

🤖 Prompt for AI Agents 
In docs/8. FAQ/Why is the google sheet sync failing.md around lines 3, 5, 22 and
24, fix capitalization and a grammar issue: change all instances of "google" to
"Google", change "google drive" to "Google Drive" on line 24, and correct
"happens" to "happen" on line 3; ensure consistency across the file by searching
for any other lowercase "google" and replacing with the proper product names.


This document details out the error conditions that make the google sheets sync to fail, and how to solve these situations are explained below.

## 1. Key can’t be blank
This happens when the `Key` columns is either empty or contains a few blank cells like shown. To solve this make sure that there are no empty cells in `Key`
<img width="272" height="442" alt="Screenshot 2025-12-24 at 1 22 59 PM" src="https://github.com/user-attachments/assets/02607de1-ac32-4b46-a578-266742e7d480" />


## 2. Unknown error or empty content

This happens when the sheet is empty or if the sheet does not contain a `Key` column. If the sheet is not empty and this error condition persists, it is likely because the Google Sheet contains a large amount of data. In such cases, the Google Sheet should be added as a table to the organization's BigQuery, and a serverless webhook should be deployed in Google Cloud Run to query the information when called from Glific. Refer to [this BigQuery and Cloud Run integration guide](https://docs.google.com/document/d/1C5FHnZuK38ukcR88ToVR689CHm6m6ijQ3zMxg6J5MRI/edit?tab=t.0#heading=h.e7zpjexh7kel) for implementation details.

## 3. Key: has already been taken

This happens when the Values in “Key” column is repeated more than once. To solve this ensure that, `Key` column contains only unique values.

## 4. Sheet not found or inaccessible

This happens if the sheet permissions are not in order. To use “read from google sheet” capability, the google sheet being used should have “anyone with the link” can “view” permission.

This condition could also occur in case the sheet is deleted from the google drive.

## 5. Repeated or missing headers
This condition happens when there are headers which are repeated, or if there are any columns where content is present but header is not specified (screenshot shows an example of sheet with missing header)


<img width="494" height="365" alt="Screenshot 2025-12-24 at 1 23 27 PM" src="https://github.com/user-attachments/assets/c3be861c-7281-42b5-aedb-90bd8688553d" />

To solve this, make sure that the headers have unique names. Also, ensure that all columns where content is present have a named header.