In the post

app/post_process.py

@@ -201,6 +201,61 @@ def fix_story_box_headlines(html_content: str) -> str:
     return html_content
 
 
+def fix_unsubscribe_link(html_content: str) -> str:
+    """Fix unsubscribe link href to use Customer.io merge tag.
+    
+    Finds links containing "unsubscribe here" text and updates their href
+    from "#" (or empty) to {% manage_subscription_preferences_url %}.
+    """
+    modified = False
+    
+    # Pattern to match <a> tag with href="#" followed by "unsubscribe here" text
+    # Matches: <a href="#" ...>...unsubscribe here...</a>
+    # This pattern captures the full link tag including attributes and closing tag
+    pattern = r'(<a[^>]*href=["\']#["\'][^>]*>.*?unsubscribe\s+here.*?</a>)'
+    
+    def replace_href(match):
+        link_tag = match.group(0)
+        # Replace href="#" with href="{% manage_subscription_preferences_url %}"
+        updated_link = re.sub(
+            r'href=["\']#["\']',
+            'href="{% manage_subscription_preferences_url %}"',
+            link_tag,
+            flags=re.IGNORECASE
+        )
+        return updated_link
+    
+    if re.search(pattern, html_content, re.IGNORECASE | re.DOTALL):
+        html_content = re.sub(pattern, replace_href, html_content, flags=re.IGNORECASE | re.DOTALL)
+        modified = True
+        print(f"  Fixed unsubscribe link href to {% manage_subscription_preferences_url %}")
+    
+    # Also handle case where just "here" is the link text (after "unsubscribe" text)
+    # Pattern: <a href="#">here</a> when preceded by "unsubscribe" text
+    pattern2 = r'(unsubscribe\s+)(<a[^>]*href=["\']#["\'][^>]*>.*?here.*?</a>)'
+    def replace_href_here_only(match):
+        before_text = match.group(1)
+        link_tag = match.group(2)
+        # Replace href="#" with href="{% manage_subscription_preferences_url %}"
+        updated_link = re.sub(
+            r'href=["\']#["\']',
+            'href="{% manage_subscription_preferences_url %}"',
+            link_tag,
+            flags=re.IGNORECASE
+        )
+        return before_text + updated_link
+    
+    if re.search(pattern2, html_content, re.IGNORECASE | re.DOTALL):
+        html_content = re.sub(pattern2, replace_href_here_only, html_content, flags=re.IGNORECASE | re.DOTALL)
+        modified = True
+        print(f"  Fixed unsubscribe 'here' link href to {% manage_subscription_preferences_url %}")
+    
+    if not modified:
+        print(f"  No unsubscribe links found that need href fixing")
+    
+    return html_content
+
+
 def add_link_spacing(html_content: str) -> str:
     """Add spaces before specific links to ensure proper spacing in email clients.
     
@@ -278,7 +333,10 @@ def minify_html(html_content: str) -> str:
     if "margin-top:0" in html_content:
         print(f"  Fixed story box headlines (added margin-top:0)")
 
-    # Step 5: Add spaces before links (ensures proper spacing in email clients)
+    # Step 5: Fix unsubscribe link href (update from # to {% manage_subscription_preferences_url %})
+    html_content = fix_unsubscribe_link(html_content)
+
+    # Step 6: Add spaces before links (ensures proper spacing in email clients)
     html_content = add_link_spacing(html_content)
 
     final_size = len(html_content)