Troubleshooting - Gmail Setup

Email Links Still Not Opening Gmail

If clicking an email hyperlink in PIPE Preview still doesn’t redirect to Gmail, try these fixes:

1. Confirm Gmail Is Actually Set as the Mail Handler

Sometimes Chrome says it’s allowed, but it doesn’t register.

Do this:

1. Open Gmail: [https://mail.google.com](https://mail.google.com)

2. Click the lock icon in the address bar

3. Click Site settings

4. Scroll to Handlers

5. Make sure it is set to Allow

Then reload Gmail and try again.

2. Remove Other Mail Handlers (Outlook, Mail App, Extensions)

Chrome will only use one handler, and Outlook often hijacks it.

Check this:

1. Go to: chrome://settings/handlers

2. Under Email, click the dropdown

3. Make sure it says:✅ mail.google.com

If you see Outlook or Windows Mail, remove them: Click the *trash icon** next to other handlers

3. Reset Handler Settings Completely

Chrome sometimes stores old protocol settings.

Reset:

1. Go to: chrome://settings/handlers

2. Scroll down to Sites that can handle protocols

3. Remove Gmail if listed

4. Restart Chrome

5. Re-add Gmail again (Step 3)

4. Check Windows Default Apps (Big One)

Even if Chrome is correct, Windows may still send mailto links elsewhere.

Fix:

1. Open Settings

2. Go to Apps → Default apps

3. Search for MAILTO

4. Set it to: ✅ Google Chrome (not Outlook)

Also check:* Email app default = Chrome

5. Test Outside PIPE First

To confirm whether PIPE is the issue or Chrome is:

Test here: Click this link in a normal webpage: 📩 mailto:test@example.com

• If Gmail doesn’t open → Chrome/Windows issue

• If it works → PIPE preview may block handlers

6. PIPE Preview Might Be Blocking mailto Links

Some embedded previews (like iframes or secure viewers) prevent redirects.

Workaround:

• Right-click the email link → *Copy email address**

• * Paste directly into Gmail compose OR * Open PIPE in a full browser tab instead of embedded preview

7. Disable Extensions That Interfere

Ad blockers, privacy tools, or email extensions can break mailto handling.

Quick test:

1. Open Chrome Incognito Ctrl+Shift+N

2. Try clicking the email link again

If it works in Incognito → an extension is interfering.

8. Clear Chrome Protocol Cache (Last Resort)

1. Go to: chrome://settings/content

2. Scroll to Additional permissions

3. Click Protocol handlers

4. Reset everything

Then restart Chrome.

9. Try a Different Browser Temporarily

Just to isolate:

• * Microsoft Edge supports Gmail handlers too

• * Firefox needs manual mailto settings

✅ Quick Best Path

If you want the fastest fix, do these 3 in order:

1. Set Windows MAILTO default → Chrome

2. Remove Outlook as a handler in Chrome

3. Test mailto link outside PIPE