Redesigning and refactoring Wagtail components
2025-10-08 , Track Two

How to handle technical and organizational challenges when refactoring Wagtail components for a smooth redesign implementation.


Refactoring components can be hard in any CMS framework due to content governance and technical challenges. When a redesign needs a block to have a new required field, drop an existing one, or change its placement, how can we guarantee that content won't be lost and that UI won't be broken? Wagtail stream field's JSON structure poses some challenges if we want to make changes to blocks' structures without having to rebuild existing content.

This talk will go over the issues we faced implementing a redesign on a Wagtail site and the lessons we learned from it.

Mariana is a full-stack developer who's passionate about coding and learning new life skills, whatever they might be. She has helped organize a regional Python conference in Brazil and given talks at national and international conferences.

Her primary focus is Python/Django, but she also enjoys front-end web development (JavaScript, HTML, CSS). She especially enjoys working with data, from databases to visualization.

In her free time, she performs aerial acrobatics and plays maracatu.