TOP 10 TROUBLESHOOTING ISSUES
Issue 1: Customer says they can’t send emails and get a delivery failure message
Error codes / on-screen text: “550 5.7.1”, “Message blocked”, “This message was not sent”
Quick Fix:
• Click the gear icon → See all settings → Accounts and Import → Check “Send mail as” for any errors
• Go to Settings → See all settings → Filters and Blocked Addresses and remove any blocking rules
• Try sending a test email to yourself first
• If using Workspace, ask admin to check domain SPF/DKIM records
Device/carrier variants: Personal Gmail: same steps. Workspace: admin must verify domain in Google Admin console. Mobile web: switch to Desktop site view first.
How to explain it to the customer: Tell the customer: “We’re checking your send-as settings and removing any blocks — this fixes most delivery failures in Gmail 2025.”
If this doesn't resolve it: Have them try sending from mail.google.com in Incognito mode. If it works, clear browser cache or disable extensions. Escalate to domain admin if Workspace.
Chasms Visual Tip: See the exact screenshot of the “Message blocked” error and Settings → Accounts and Import on Chasms.com
Issue 2: Customer says important emails are going straight to Spam or Promotions
Error codes / on-screen text: Emails appear in Spam or Promotions tab instead of Primary
Quick Fix:
• Open the email in Spam → click “Not spam”
• Go to Settings → See all settings → Filters and Blocked Addresses → create a new filter for the sender
• In the same menu, move Promotions or Social to Primary if desired
• Train the filter by moving several emails manually to Primary
Device/carrier variants: Workspace accounts: admin can adjust spam confidence threshold in Admin console. All browsers: same filter path.
How to explain it to the customer: Tell the customer: “We’re marking the email as Not spam and creating a filter so future ones go straight to Primary.”
If this doesn't resolve it: Check if the sender’s domain has poor reputation using external tools, then whitelist the entire domain.
Chasms Visual Tip: See the exact screenshot of Settings → Filters and Blocked Addresses on Chasms.com
Issue 3: Customer can’t log in — “Wrong password” or 2FA code not working
Error codes / on-screen text: “Wrong password. Try again or click Forgot password”, “Invalid code”
Quick Fix:
• Click “Forgot password” and follow recovery flow (use backup email or phone)
• If using passkey, make sure the device is unlocked and Bluetooth is on
• Try signing in from Incognito mode to rule out extension interference
• Generate a new app password if using IMAP/legacy apps
Device/carrier variants: Workspace: admin can reset password or disable 2FA temporarily. Mobile web: use “Desktop site” for full recovery options.
How to explain it to the customer: Tell the customer: “We’re going through the password recovery flow and checking your 2FA device — this resolves most login issues.”
If this doesn't resolve it: Check Google Account security page for recent suspicious activity and sign out all other sessions.
Chasms Visual Tip: See the exact screenshot of the 2FA and recovery screen on Chasms.com
Issue 4: Customer can’t attach or download files — error during upload
Error codes / on-screen text: “Attachment failed to upload”, “File too large”, “Virus scan failed”
Quick Fix:
• Check file size (max 25 MB per attachment for most accounts)
• Try zipping the file or uploading one at a time
• Disable browser extensions temporarily
• Clear browser cache and cookies for mail.google.com
Device/carrier variants: Workspace: larger attachment limits may be available via admin. All browsers: same size limit.
How to explain it to the customer: Tell the customer: “We’re checking the file size and clearing cache — this fixes most attachment errors in Gmail 2025.”
If this doesn't resolve it: Try uploading from Drive first then attaching the Drive link instead of the file.
Chasms Visual Tip: See the exact screenshot of the attachment error dialog on Chasms.com
Issue 5: Gmail web is extremely slow or won’t load at all
Error codes / on-screen text: Spinning loader forever, blank white screen, or “Loading…”
Quick Fix:
• Refresh the page (Ctrl + Shift + R for hard refresh)
• Try Incognito mode to disable extensions
• Clear browser cache for mail.google.com only
• Disable hardware acceleration in browser settings if using Chrome/Edge
Device/carrier variants: Firefox users: disable Enhanced Tracking Protection for mail.google.com. Workspace: check if any admin policies are slowing the interface.
How to explain it to the customer: Tell the customer: “We’re doing a hard refresh and testing in Incognito — this usually gets Gmail loading again.”
If this doesn't resolve it: Check internet connection speed and try a different browser.
Chasms Visual Tip: See the exact screenshot of the loading spinner and Incognito test on Chasms.com
Issue 6: Search is not finding emails that the customer knows exist
Error codes / on-screen text: “No results found” even for recent emails
Quick Fix:
• Use exact search operators: from: [email protected] after:2025/04/01
• Go to Settings → See all settings → General → turn on “Search in spam & trash” temporarily
• Wait 5–10 minutes after sending/receiving — indexing can lag
• Try the new Gemini-powered search bar with natural language
Device/carrier variants: Workspace: search may be restricted by admin retention policies. All browsers: same operators work.
How to explain it to the customer: Tell the customer: “We’re using advanced search operators and checking spam — Gmail’s index sometimes needs a minute to catch up.”
If this doesn't resolve it: Have them check the “All Mail” label instead of Inbox.
Chasms Visual Tip: See the exact screenshot of the search bar and advanced operators on Chasms.com
Issue 7: Gemini “Help me write” or smart replies are missing or not working
Error codes / on-screen text: Gemini sidebar not appearing or grayed out
Quick Fix:
• Go to Settings → See all settings → Gemini and toggle features ON
• Make sure the account is opted into Gemini (may require Workspace admin approval)
• Refresh the page or sign out and back in
• Check browser console for any blocked scripts (rare)
Device/carrier variants: Personal Gmail: available immediately. Workspace: admin must enable “Gemini for Gmail” in Admin console first.
How to explain it to the customer: Tell the customer: “We’re enabling Gemini in settings — this feature sometimes needs to be turned on manually after updates.”
If this doesn't resolve it: Confirm the account has Gemini access via the Google Account page.
Chasms Visual Tip: See the exact screenshot of Settings → Gemini on Chasms.com
Issue 8: Labels or filters are not working or emails are not moving automatically
Error codes / on-screen text: Emails stay in Inbox despite active filters
Quick Fix:
• Go to Settings → See all settings → Filters and Blocked Addresses → edit or recreate the filter
• Make sure the filter uses correct syntax and is not conflicting with another rule
• Test by sending a test email that should match the filter
• Check if the label still exists (labels can be accidentally deleted)
Device/carrier variants: Workspace: some filters may be domain-wide and managed by admin. All browsers: same filter editor.
How to explain it to the customer: Tell the customer: “We’re editing the filter and testing it with a new email — this fixes most automation issues.”
If this doesn't resolve it: Export filters, delete them, then re-import after a browser cache clear.
Chasms Visual Tip: See the exact screenshot of the Filters and Blocked Addresses page on Chasms.com
Issue 9: Customer sees “Suspicious sign-in attempt” or account appears compromised
Error codes / on-screen text: “New sign-in from [location]” email or “Your account may have been compromised” banner
Quick Fix:
• Go to myaccount.google.com/security → Review recent security activity
• Sign out all other sessions immediately
• Change password and enable or re-verify 2FA / passkey
• Run the Google Account Security Checkup
Device/carrier variants: Workspace: admin can force password reset and review admin logs. All browsers: same security page.
How to explain it to the customer: Tell the customer: “We’re reviewing recent sign-ins and signing out other devices — this is the first step for any security alert.”
If this doesn't resolve it: Enable “Advanced Protection Program” if the account is high-value.
Chasms Visual Tip: See the exact screenshot of myaccount.google.com/security on Chasms.com
Issue 10: Emails are not syncing between web and mobile app
Error codes / on-screen text: Emails appear on web but missing on phone or vice versa
Quick Fix:
• On mobile app: Settings → Accounts → Gmail → Sync now
• On web: make sure Offline mode is not causing sync lag
• Check internet connection on both devices
• Sign out and back into the mobile app
Device/carrier variants: iOS: also check Settings → Mail → Accounts. Android: clear Gmail app cache. Workspace: check if any sync restrictions are applied by admin.
How to explain it to the customer: Tell the customer: “We’re forcing a manual sync on the phone and checking your connection — this usually resolves sync issues between web and app.”
If this doesn't resolve it: Remove and re-add the account on the mobile device.
Chasms Visual Tip: See the exact screenshot of mobile Gmail sync settings on Chasms.com
AGENT Q&A PAIRS
Q: Customer says emails are bouncing with “550 5.7.1” — what do I check first in Gmail 2025?
A: Have them go to Settings → See all settings → Accounts and Import and verify their “Send mail as” address. Then check Filters and Blocked Addresses for any blocking rules. That resolves most delivery failures.
Q: Customer’s important emails keep landing in Spam — how do I fix it quickly?
A: Tell them to open the email in Spam, click “Not spam”, then create a filter for the sender in Settings → See all settings → Filters and Blocked Addresses. Move the category to Primary if needed.
Q: Customer can’t log in even with the correct password and 2FA code — what’s the fastest path?
A: Walk them through the “Forgot password” flow and have them check myaccount.google.com/security for recent suspicious activity. Then sign out all other sessions.
Q: Customer gets “Attachment failed to upload” every time — what do I tell them?
A: Confirm the file is under 25 MB, try zipping it, and have them clear browser cache for mail.google.com. If it still fails, attach from Drive instead.
Q: Gmail web is stuck on a white loading screen — how do I get it working again?
A: Have them do a hard refresh (Ctrl + Shift + R), try Incognito mode, and disable hardware acceleration in browser settings. That fixes it for most users.
Q: Search isn’t finding emails the customer knows are there — what operators should I have them use?
A: Tell them to try from:[email protected] after:2025/04/01 or use the new Gemini search bar with natural language like “receipts from last month”.
Q: Gemini “Help me write” is missing after the 2025 update — how do I turn it back on?
A: Direct them to Settings → See all settings → Gemini and toggle the features on. Workspace users may need admin approval first.
Q: Customer’s filters stopped moving emails automatically — what’s the fix?
A: Have them go to Settings → See all settings → Filters and Blocked Addresses, edit the filter, and test it with a new email. Conflicting rules are the usual culprit.
Q: Customer got a “Suspicious sign-in” email — what do I walk them through right now?
A: Tell them to go to myaccount.google.com/security, review recent activity, sign out all other sessions, and change their password immediately.
Q: Emails are showing on web but not on the phone app — how do I fix the sync?
A: Have them force sync on the mobile app (Settings → Accounts → Gmail → Sync now) and check their internet connection on both devices. If needed, remove and re-add the account on mobile.
