The discussion revolves around tweaking the text around email unsubscribe links in notification emails. ToddZ wants to know which of the two Site Texts entries (unsubscribe_link and unsubscribe_link_and_mail) appears in the footer of typical notification emails and where the other is used.
Lilly points out that both can be customized, and provides a link to related settings.
Simon clarifies that the unsubscribe_link text is used when the unsubscribe_via_email_footer site setting is not enabled, and unsubscribe_link_and_mail is used when it is enabled. However, the default values of both text strings create identical links, making it safe to customize both.
Lilly provides more context from the Askbot, and ToddZ thanks both for their help, concluding that changing both texts is a safe approach.
I’d like to tweak the text around email unsubscribe links in typical notification emails.
Site Texts contains these two entries with the same content:
unsubscribe_link
unsubscribe_link_and_mail
Default text for both is:
To unsubscribe from these emails, [click here](%{unsubscribe_url}).
Obviously one of these appears in the footer of typical notification emails, but which – and where is the other used?
Making the same customization to both the unsubscribe_link and unsubscribe_link_and_mail entries seems like the safest approach.
As Lilly noted, which text string gets used is dependent on the unsubscribe_via_email_footer site setting. Testing it on my local installation, the unsubscribe_link text gets added to the email if the unsubscribe_via_email_footer setting is not enabled. The unsubscribe_link_and_mail text gets added to the email if the unsubscribe_via_email_footer setting is enabled.
The default values of each of the text strings seem to create identical links and lead to identical ways of allowing users to manage their email preferences.
The logic seems to be here: discourse/lib/email/message_builder.rb at 2dae20c05434cdb96f59a996167f77a389169c4d · discourse/discourse · GitHub
Based on the description of the unsubscribe via email footer site setting, I’m guessing that it used to cause a mailto link to be inserted into the email:
Attach an unsubscribe via email mailto: link to the footer of sent emails
That doesn’t seem to be the case anymore though.
Some more context from the ask bot 
https://ask.discourse.com/discourse-ai/ai-bot/shared-ai-conversations/gYtJ3msprWlbS9Suzmpc2w
Very cool, thank you both! I’m sure I’ll make use of the Askbot in the future… I wasn’t aware of its capabilities and hadn’t seen an example before.
I was off studying the transcript @Lilly provided when @Simon posted the conclusion I was coming to: since I have unsubscribe via email footer active, the text for unsubscribe_link_and_mail would be used, but there doesn’t seem to be any downside to changing both texts.
