Everything HubSpot CMS

How Do HubSpot Content Hub Theme Files and Folder Structures Work?

Written by Deepti Mittal | May 17, 2026 2:30:00 PM

Themes play an important role in how websites are built and managed in HubSpot Content Hub. A theme defines the overall design system of a website, including templates, styles, modules, and layout structures.

Themes are organized using a structured folder system inside the HubSpot design manager, which allows developers to manage files efficiently while building scalable websites.

Understanding how HubSpot Content Hub theme files and folder structures work helps developers and teams maintain organized, reusable design systems.

What Is a Theme in HubSpot Content Hub?

A theme n HubSpot Content Hub is a collection of files that define how a website looks and behaves.

A typical theme may include:

  • Page templates
  • Global modules (header, footer)
  • Custom modules
  • CSS stylesheets
  • JavaScript files
  • Theme settings

Themes help maintain consistent design across all pages of the website.

Where Themes Are Managed

Themes are managed inside the HubSpot Design Manager.

To access the design manager:

Content → Design Manager

This tool allows developers to view and edit theme files and other design assets.

Typical Theme Folder Structure

Themes in HubSpot Content Hub are organized into folders that contain different types of files.

A typical theme structure may look like this:

theme-name/
│
├── templates/
│   ├── homepage.html
│   ├── landing-page.html
│   └── blog-post.html
│
├── modules/
│   ├── hero-banner.module
│   ├── feature-grid.module
│   └── testimonial-slider.module
│
├── css/
│   └── theme.css
│
├── js/
│   └── theme.js
│
├── images/
│   └── theme-assets
│
└── theme.json

Each folder serves a specific purpose within the theme.

Templates Folder

The templates folder contains page templates used to build different types of pages.

Examples include:

  • Homepage template
  • Landing page template
  • Blog post template
  • Resource page template

These templates define the layout structure of pages.

Modules Folder

The modules folder contains reusable modules used throughout the website.

Modules may include components such as:

  • Hero sections
  • Feature blocks
  • Pricing tables
  • Image galleries
  • CTA sections

Modules allow editors to easily build pages without needing to modify templates.

CSS and JavaScript Files

Themes usually include CSS and JavaScript files that control styling and interactive behavior.

These files help define:

  • Colors and typography
  • Layout spacing
  • Animations
  • Interactive elements

Developers can update these files to adjust the design of the website.

Theme Settings File

The theme.json file controls the configuration of the theme.

This file may define:

  • Global color palettes
  • Typography options
  • Spacing settings
  • Layout configurations

Theme settings allow editors to adjust design elements without modifying code.

Why a Structured Theme System Matters

Using a structured theme system helps developers and teams maintain organized projects.

Benefits include:

  • Easier maintenance of website files
  • Consistent design across pages
  • Faster page creation for editors
  • Better scalability as websites grow

Themes provide a foundation that supports long-term website management.

Key Takeaway

HubSpot Content Hub themes organize templates, modules, styles, and scripts into a structured folder system. This structure allows developers to build scalable websites while giving content editors the flexibility to create and manage pages easily.