Working with layouts
A layout holds the sections every template using it shares, such as the navigation and the footer. Templates & structure explains where it sits in the hierarchy. This page is about managing the layouts themselves.
Every project has a default layout. Adding your own needs Pro; on Free the add button answers Custom layouts need Pro.
Add one
Use the add button at the top of the Layouts list. A new layout starts empty, and you add sections to it the same way you would on a template.
Duplicating is usually faster. Duplicate in a layout's context menu copies its sections into a new layout you can then diverge.
Assign it to a template
A layout does nothing until a template uses it. Open a template's context menu and pick from its Layout row.
Tagged templates cannot be reassigned, because they render through a partial rather than through a layout of their own.
Rename and delete
Rename changes the name shown in the sidebar. It does not change the exported filename.
Delete is blocked on the default layout and on a locked one, since something has to remain for templates to fall back to. When you delete a layout that templates are using, the confirmation tells you how many, and those templates switch back to the default layout rather than breaking.
The exported filename
The File: row in the context menu sets the .hbs name the layout exports under. Leave it empty and Fantasma picks a name from the layout's own name.
Change it when you need a specific filename, for a Ghost integration or a convention your team already follows. The default layout's filename is fixed.
Download or publish again
Layout changes affect every template using that layout. Download a new ZIP or publish before expecting the live site to match.