Forums/Official SendGrid/FAQ: Apps

Help, The Unsubscribe Links Aren't Working!

Joe Scharf
posted this on March 15, 2010 16:42

If you find that your Unsubscribe links aren't working, its usually because the link placeholder <% %> has not been included in the HTML or Text portions of the Subscription Tracking filter settings as is shown in Figure 1:

 

Figure 1 - Missing Unsubscribe Placeholder:

Subscription_Tracking_Settings_Wrong.png

 

To correct this you can add the unsubscribe placeholders <% %> at the place in the text editor where you want the unsubscribe link to appear. You can add text inside the unsubscribe placeholders (i.e. <% click here %> ) To replace the link with custom text on the HTML version of the email. See Figure 2 for the correct way to specify the Subscription Tracking filter settings:

 

Figure 2 - Adding the Unsubscribe Placeholder

Subscription_Tracking_Settings_right.png

 

Comments

User photo
Matías Montes

I have subscription tracking filter enabled with the following configuration:

 

Replacement tag: subscription

Html body: You are receiving this email because you signed up for Xxxxx’s daily alerts. If you would like to stop receiving promotional emails from us, &lt;% unsubscribe here %&gt;.

Text body: You are receiving this email because you signed up for Xxxxxx’s daily alerts. If you would like to stop receiving promotional emails from us, unsubscribe here <%  %>.

 

I am sending an HTML message and I want the unsubscribe message to be included inside the body. For this I tried using "subscription", "<% subscription %>", and "&lt;% subscription %$gt;"  within the mail body

In all three cases, the "subscription" tag was replaced by a link to unsubscribe but instead of displaying the whole message I had set up, I get the full url displayed

 

Other filters I have set up:

  • Domain Keys
  • Click Tracking
  • Open Tracking
  • Footer

 

Any help would be very appreciated

June 14, 2010 13:20.
User photo
Matías Montes

Sorry, I had a typo on the previous connect where it reads %$gt; it should read %&gt;

June 14, 2010 13:21.
User photo
Todd Crutchfield

I am having the same issue but am unclear as to how the tag gets inserted into the HTML email:

Tage Name: unsubscribe

HTML Body:  If you'd like to unsubscribe and stop receiving these emails <% click here %>.

Text Body:  If you'd like to unsubscribe and stop receiving these emails click here: <% %>.

What is the tag that we need to use in the HTML email?

 

Thanks!

November 12, 2010 14:15.
User photo
Todd Crutchfield

Just to clarify, currently we are using, <unsubscribe> and the tag is replaced with a link.  We want to replace with the message specified in HTML Body.

November 12, 2010 14:24.
User photo
Matías Montes

I managed to fix this.

This is my set up

  • Replacement tag:  --unsubscribe--
  • Unsubscribe Content - HTML Body: (empty)
  • Unsubscribe Content - Text Body: (empty)

Then in my email I add the link in the folowing way:

 

<a href="--unsubscribe--">Click here to unsubscribe</a>

 

November 15, 2010 11:34.
User photo
Felix Koch

Doesn't work for me too.

Replacement tag is on substituted with the subscription url. Body-texts are completely ignored. Matías Montes comment is only a work around, but not a solution.

Please help.

Regards Felix

February 14, 2011 04:33.
User photo
Sebastiaan Hulst

I think it does, read what it says:  If no tag is found, we will simply place the unsubscribe information at the bottom of the email. So if there is NO tag supplied in your email (lets say you forgot to add --unsubscribe--, then it would add the html. Otherwise it will just replace --unsubscribe-- with the url. Seems not as a bug but as required behavior.

July 27, 2011 06:01.
User photo
Brent

I'm trying to use "Replacement Tag" to add the unsubscribe link to the html and text in the newsletter and none of the suggestions here seem to be working for me.

September 22, 2011 17:08.
User photo
Brent

FYI, I was able to get this fixed because a Sendgrid staff member said I needed to use [unsubscribe] in my html and text template for the "Replacement Tag". I also changed the "Replacement Tag" to "[unsubscribe] in the unsubscribe app on Sendgrid.

Sendgrid might want to take a look at this app and run some tests because it seems buggy.

September 23, 2011 10:18.
User photo
Jacob Lee
SendGrid

First of all, Sebastiaan is right: by default, we will place the string from Text/HTML body at the foot of the message. if you've entered a replacement tag, and that tag is in the message, we will instead replace the tag with the URL only, so you would need to do something like:

To unsubscribe, <A HREF=-unsub->click here</A>. 

 Secondly, it's important to note that the Subscription Tracking settings to not affect the Newsletter app in any way. Also, there is a discrepancy between the Newsletter formatting and the Subscription Tracking formatting. For Newsletter, you should use [unsubscribe] for both HTML and plain Text, like this:

HTML: To unsubscribe please <a href="[unsubscribe]">click here</a>
Text: To unsubscribe please click here: [unsubscribe]

Whereas for settings in the Subscription tracking app, it would look like this:

HTML: To unsubscribe please  <% click here %>
Text: To unsubscribe please click here: <% %>

You can customize the default footer in the Subscription Tracking app as much as you want, so long as you have the appropriate <% and %>.

We're working to normalize these tags, so prevent this confusion in the future.

September 26, 2011 07:31.