Skip to main content

Troubleshooting missing Unsubscribe button

Reasons why the unsubscribe button might not be appearing when sending a mail merge

Amanda avatar
Written by Amanda
Updated over a week ago

When you send a mail merge with Streak’s advanced settings enabled, Gmail will display an "Unsubscribe" button at the top of your emails to help recipients easily opt-out. However, Gmail ultimately controls when and how that link appears, and sometimes it doesn’t show up as expected.

Here are a few reasons why the unsubscribe button might be missing, and how you can troubleshoot:

1. SPF, DKIM, and DMARC Setup

Gmail uses email authentication settings like SPF, DKIM, and DMARC to verify that you are authorized to send on behalf of your domain. If these are not set up correctly, Gmail may treat your emails differently, including not showing the unsubscribe link.

💡 Tip: You can check your domain’s SPF, DKIM, and DMARC settings using online tools like MxToolbox.

2. Sending Tests to Yourself

If you are testing a mail merge by sending to your own address or team member’s email, Gmail may not show the unsubscribe button. Since it does not make sense to unsubscribe from your own email, Gmail will often hide the link during tests.

💡 Tip: Try sending a test to a different email address that is not associated with your Gmail account or Streak team (ideally an external email address).

3. Frequency and Reputation

Gmail sometimes factors in how often you send emails and the reputation of your previous sends when deciding whether to show the unsubscribe button. If you are just starting out with mail merges or have not built a strong sending reputation yet, Gmail might not immediately show it.

💡 Tip: Make sure you are following Gmail’s sending best practices, such as sending relevant and personalized emails, to build a positive reputation over time.

4. Email Content

The content of your email can also affect whether Gmail decides to show an unsubscribe link. If your message looks like a regular, one-off personal email, Gmail may not see a need to add an unsubscribe option. On the other hand, if your email appears more promotional or marketing-focused, the likelihood of the unsubscribe button appearing increases.

💡 Tip: Use personalization variables and follow mail merge best practices to help Gmail recognize your message as part of a legitimate bulk send.

Even if everything is set up correctly, Gmail can be unpredictable. In some cases, the unsubscribe link appears after waiting a few hours or a day or two without making any changes. Give it a little time and check back later. In many cases, the unsubscribe button will eventually show up on its own.

Still not seeing the unsubscribe button?

Feel free to contact our team by starting a chat or email us at support@streak.com. We are happy to help you troubleshoot!

Did this answer your question?