Docs / Getting Started / Switch a Page to a Child Theme

Switch a Page from the Parent Theme to a Child Theme

If you built pages on the parent blox theme before cloning your child theme, you can migrate them onto the child without rebuilding. HubSpot lets you swap the template (and with it, the underlying theme) while preserving all the content modules and copy on the page.

Why migrate to the child theme

Pages on the parent theme cannot use your child theme's overrides - the cloned Header module, custom CTA styles, brand colors, or any module you have customized in the child are all invisible to a parent-theme page. Migrating moves the page into the child theme's inheritance chain so it picks up everything your brand has configured.

Before you start

  • Your child theme exists and is fully configured.
  • You have run through Add Your Brand Style on the child theme's settings.
  • You know the name of the template the current page uses (you will reapply the same template, just from the child instead of the parent).

Step-by-step

1. Open the page in the editor

HubSpot Marketing → Website → Website Pages

Find the parent-theme page in your page list and open it in the editor.

2. Open the page Settings tab

Editor tab

Click the Settings tab at the top right of the editor. Scroll to the Template section and note the current template name (for example, "Home - Opt 2", "About", or "Pricing"). You will reapply the same template after switching themes.

3. Click "Use different template"

Action

In the Template section, click Use different template. The template picker opens with a theme selector at the top.

4. Select your child theme

Theme selector

From the theme dropdown, pick your child theme (for example, blox x Acme Corp) instead of the parent blox.

5. Search for the same template name

Template picker

Use the search bar to find the template you noted in step 2. The child theme inherits every template from the parent, so the same template names will appear. Select the matching one.

6. Preview before applying

Action

HubSpot shows a preview of your existing page content rendered on the new template. Confirm everything looks right - all modules, copy, images, and links should carry over cleanly.

7. Click "Use template"

Action

Click Use template in the top-right corner of the preview to finalize the switch. The page is now bound to the child theme. Publish to push the change live, or keep working in draft.

What to check after migrating

  • Header and footer match the child theme's configuration (logo, nav items, copy, social links).
  • CTAs render with the child theme's tier styling.
  • Heading and body fonts pick up the child theme's typography overrides.
  • Any module you customized in the child shows its child-theme behavior, not the parent default.

If something looks off, re-open Theme Settings on the child theme and verify the relevant group is configured.

Warnings

  • Module data persists, but module structure must match. If a module was renamed or restructured in the child theme, the field data may not map perfectly. Stick to plain template swaps unless you have intentionally customized module fields.
  • Switching is per page. There is no bulk "migrate all pages" action in HubSpot - you have to repeat steps 1-7 for each page. For sites with hundreds of pages, plan a phased rollout.
  • Always preview first. Once you click "Use template," the change is live in the editor. You can revert by reopening the template picker and selecting the parent theme version, but it is faster to catch issues during preview.