Forum Discussion

ryan_quinlan's avatar
ryan_quinlan
Active Member
11 months ago

List-unsubscribe header with preference center page

Our company uses a custom preference center page as our unsubscribe link, so that customers can opt-out of any or all subscription groups (custom preference center created via API: https://www.braze.com/docs/user_guide/message_building_by_channel/email/preference_center/overview/#step-1-create-a-preference-center-via-api). What’s the expected behavior for the unsubscribe link header in this case, will the custom preference center link be pulled into the unsub header?

  • Goot's avatar
    Goot
    Practitioner III

    Hey Ryan! This is a great question for our Product Team to take a look at, but here's what I know: The preference center page is totally fine for the required unsubscribe option in the body of the message, but the list-unsubscribe header needs to be a true one-and-done unsubscribe option that happens seamlessly within the mailbox UI and doesn't require any additional user input. You can read more about it in RFC8058 if you're feeling especially nerdy. đź™‚ Hope that helps a little!

    • jennifer's avatar
      jennifer
      Braze Employee

      Hey ryan_quinlan Goot is 100% correct here that your list-unsubscribe header cannot direct users to a preference center as that goes against RFC 8058. It needs to be a one-click unsubscribe URL that adheres to the protocol

    • EmPaulin's avatar
      EmPaulin
      Practitioner III

      summing up, can you have your unsubscribe link AND a change your preferences link? would that be OK? 

  • Follow-up question to this: If we use the expected List-Unsubscriber-Post tags in our headers, what happens in Braze? AKA how does Braze handle the response? I'm looking at Google's example code here:

     

    To set up one-click unsubscribe, include both of these headers in outgoing messages:

    When a recipient unsubscribes using one-click, you receive this POST request:

    "POST /unsubscribe/example HTTP/1.1
    Host: solarmora.com
    Content-Type: application/x-www-form-urlencoded
    Content-Length: 26
    List-Unsubscribe=One-Click"

  • Hi

    I know that I can active Email Unsub Header by going into Settings > Email Preferences. However, we have a custom page to handle unsubs due to how many brands we have. How do I add the URL to the email header in an email template. Are we saying that I have to do it manually every time I want to create a canvas? Is there a way to add it to an email template?