Theme Documentation

Why Am I Getting An Error When Trying to Create a Child Theme?

HubSpot limits the number of child themes a portal can create based on your subscription.

  • Marketing Hub Professional or CMS Hub Professional: 5 child themes
  • Marketing Hub Enterprise or CMS Hub Enterprise: 10 child themes
  • HubSpot’s free tools and CMS Hub Starter: 1 child theme

Understanding Child Theme Limits and Best Practices

When you encounter an error creating a child theme in HubSpot, it’s typically because you’ve reached your subscription’s child theme limit. Child themes are powerful tools that allow you to customize an existing theme while preserving the ability to receive updates from the parent theme.

Why These Limits Exist

HubSpot implements these restrictions to encourage thoughtful theme management and prevent portal bloat. Each child theme consumes server resources and requires maintenance, so the limits align with your subscription level’s expected usage patterns.

Managing Your Child Theme Allocation

Before creating a new child theme, audit your existing ones in the design manager. You may find unused or redundant child themes that can be deleted to free up slots. Consider whether you truly need a separate child theme or if your customizations can be achieved through the theme’s built-in settings panel or custom modules.

Strategic Child Theme Usage

Create child themes when you need distinct visual variations for different site sections or when testing major design changes. For example, you might use one child theme for your main website and another for a specialized landing page campaign with unique styling requirements.

Alternative Customization Methods

If you’re at your limit, explore other customization options first. Many Lynton themes include extensive theme settings accessible through the page editor, allowing you to modify colors, fonts, and layouts without creating child themes. You can also use the drag-and-drop page editor to create unique page layouts using existing modules.

Subscription Upgrade Considerations

If you consistently hit your child theme limit, consider whether upgrading your HubSpot subscription makes sense for your organization’s growth and design flexibility needs.