---
aliases: ["Migrate newsletter archive to new template"]
Is A: Task
Belongs to: "[[25q2]]"
Status: Done
Owner: "[[person-luca-rossi]]"
---
# Migrate newsletter archive to new template

The newsletter archive on the website was using a template designed in early 2023 that no longer matched the current brand identity. The archive is a significant traffic driver (roughly 40% of organic search traffic lands on archive pages), so the template needed to be updated for both aesthetic and functional reasons. The new template introduced better typography, a table of contents for long articles, improved code block rendering, and prominent CTAs for subscribing.

The migration involved updating the template, testing it across all 120+ archive pages, and ensuring no SEO regressions from URL changes or broken structured data. [[person-sara-ricci]] reviewed the visual design while [[person-luca-rossi]] handled the technical implementation.

## Acceptance criteria

- [x] Design and implement new archive page template matching current brand guidelines
- [x] Migrate all 120+ archive pages to the new template
- [x] Add table of contents, improved code blocks, and subscribe CTAs to the template
- [x] Verify no broken links, missing images, or SEO regressions after migration
- [x] Monitor search traffic for 2 weeks post-migration to confirm no negative impact

## Notes

- The migration went smoothly with no SEO regressions. Organic traffic actually increased by roughly 8% in the two weeks post-migration, likely due to improved page load times and better mobile rendering.
- The subscribe CTA in the new template generates approximately 200 new subscribers per month from archive traffic -- previously there was no CTA on archive pages at all.
- [[person-sara-ricci]] caught several formatting issues during the review that would have gone unnoticed, reinforcing the value of having a dedicated editorial eye on technical changes.
