Templates, layouts, sections, and blocks

Fantasma projects are built as a small hierarchy. Knowing the levels helps you decide where to add something and why a setting affects one page, several pages, or only one item.

The hierarchy

Templates are the Ghost page types you design: home, post, page, tag, author, collection, error, and similar. Each template defines the main page structure for that context.

Layouts are shared wrappers. A layout usually contains global framing such as header and footer, and multiple templates can use the same layout.

Sections are always first-level page pieces inside a template or layout. They create the main vertical regions of the page, such as a hero, post list, newsletter band, or footer area.

Blocks are nested inside sections, usually on the second or third level. They are smaller editable pieces such as headings, buttons, rich text, cards, images, and repeated items.

Example

A custom collection template might use your default layout, start with a hero section, then show a Posts List section. Inside the hero, blocks control the heading, text, and buttons. Inside the post list, blocks or item settings control the card content.

Ghost still owns the posts and tags. Fantasma owns how that collection page is shaped.

Add-section choices

The Add Section to Template dialog may show many options even when Fantasma has a smaller set of underlying section types. That is intentional: many choices are prepared starting layouts built from the same section system. They save setup time, and after insertion you edit them like any other section.

Download or publish again

Any change to templates, layouts, sections, or blocks that should appear on the live site needs Download ZIP or Publish and that build installed or activated in Ghost.