Quick tipGotchaContent HubDesign Manager

Your coded HubSpot template is missing from the template picker? Look under Other

You built a template in Design Manager, it has no errors, and it still does not show up when you create a page. Before you debug permissions or publish settings, check one menu item.

Subscription
Any tier with website or landing pages
Permissions
Website or landing page access
Time
3 min · Beginner
Last verified

Short answer

The Select a template page opens on your active theme's templates, and its search does not reach outside that view. Templates that are not inside a theme folder (at the Design Manager root or in a plain folder) are listed only under Other in the left menu. If a template is not under Other either, check its annotation: it needs templateType: page and isAvailableForNewContent: true.

Where non-theme templates live in the picker

Go to Website pages or Landing pages and click Create. The Select a template page opens on your active theme, and the left menu has three places to look.

Select a template page with the active theme, theme templates, and Other highlighted in the left menu
Active theme (1), its templates (2), and Other (3).

Click Other (3). Any page template that is not part of a theme shows up there. HubSpot's own documentation says it in one line: to use a template that isn't part of a theme, click Other in the left side menu.

Other selected in the template picker, showing No templates match the selected filters
In this portal every template lives in a theme, so Other is empty. Yours will list your coded templates.
Search will not find it

The search box at the top of the picker searches the view you are in. From the default theme view, it does not surface templates that sit under Other. Click Other first, then search.

Why your template counts as "Other"

Open Design Manager and look at the folder icons in the left panel. Theme folders have a different icon from plain folders. A template inside a theme folder belongs to that theme. A template at the root, or in a plain folder, belongs to no theme, so the picker puts it under Other.

Design Manager file tree with a theme folder and a plain folder highlighted
A theme folder (1) versus a plain folder (2). Editor names are blurred.

This is common with agency-built and older sites, where templates were coded before themes existed, or copied out of a theme to make a one-off variation.

Not under Other either? Check the annotation

Every coded template starts with an annotation comment. For a template to be offered when someone creates a page, it needs to be a page template and be available for new content:

<!--
  templateType: page
  isAvailableForNewContent: true
  label: Campaign landing page
-->

With isAvailableForNewContent: false, the template is hidden from page creation on purpose. HubSpot uses that setting for partials and templates you only want to apply to existing pages.

Related gotcha: copying a theme template to the root

If you copy a theme template out to the Design Manager root so it shows up under Other, check its first line. Theme templates usually extend a layout with a relative path:

{% extends "./layouts/base.hubl.html" %}

At the root, ./layouts/ points to a folder that does not exist. The template renders without its parent layout, every drag-and-drop area disappears, and the page editor reports that the template doesn't allow modules to be added. Point the extends at the theme's layout with a full path from the Design Manager root instead, for example {% extends "/Your Theme/templates/layouts/base.html" %}.

Sources

New field notes by email

One email when a new article publishes.

Still stuck?

If this did not fix it, the problem is probably specific to your setup. Book a call and we will look at it together.

Book a call with Sam