Why Is a Theme Update Not Showing In My Module? | HubSpot Theme Docs

There is an issue in HubSpot where module instances already in use on a page will sometimes not have updates applied to them. You will need to delete the module from the page and re-add it to see any updates.

Understanding Module Update Behavior

This update issue occurs because HubSpot caches module instances to improve page loading performance. When you make changes to a module’s default settings, field options, or styling within the theme files, these updates may not automatically propagate to existing module instances that content editors have already placed on pages through the drag-and-drop page editor.

Why this happens: Once a module is added to a page and configured by a content editor, HubSpot treats it as a customized instance with its own saved settings. The system prioritizes preserving any custom configurations you’ve made over applying new theme-level defaults, which can prevent updates from appearing.

Before removing modules: First, try refreshing the page editor and checking if the updates appear after clearing your browser cache. Sometimes a simple refresh resolves the display issue without requiring module deletion.

Best practices for module updates: When you need to remove and re-add a module, take screenshots of your current module settings first. This allows you to quickly reconfigure the module with the same content, images, and styling choices. You can also copy any custom text content to avoid retyping lengthy descriptions or headlines.

For frequently updated modules: If you’re working with modules that receive regular updates from your development team, consider creating template pages with the standard module configurations. You can then clone these templates when building new pages, ensuring you start with the most current module versions.

Team coordination: Communicate with other content editors when theme updates are deployed. They should know which modules may need refreshing and can plan their content updates accordingly to minimize disruption to live pages.