Quick-search for anything
⌘F

Page

Use: {{#is "page"}}{{/is}} to detect this context

Whenever you’re viewing a static page, you’re in the page context. The page context is not set on posts, which uses the post context instead.

Routes

The URL used to render a static page is always /:slug/. This cannot be customised, unlike post permalinks.

Templates

The default template for a page is post.hbs and an optional page.hbs template can be used.

Custom templates for specific pages are determined using page-:slug.hbs, with the :slug matching the static page’s slug.

For example, if you have an ‘About’ page with the url /about/, adding a template called page-about.hbs will cause that template to be used instead of page.hbs, or post.hbs.

These templates exist in a hierarchy. Ghost looks for a template which matches the slug (page-:slug.hbs) first, then looks for page.hbs and finally uses post.hbs if neither is available.

Data

The page context provides access to the post object which matches the route. A page is just a special type of post, so the data object is called a post, not a page. As with all contexts, all of the @site global data is also available.

When outputting the page, the block expression {{#post}}{{/post}} is used to drop into the post scope and access all of the attributes. All of the data available for a page is the same as the data for a post.

Post (page) object attributes

  • id — incremental ID of the page
  • title — the title of your static page
  • excerpt — a short preview of your page content
  • content — the content of the page
  • url — the web address for the static page
  • feature_image — the cover image associated with the page
  • feature_image_alt — alt text for the cover image associated with the page
  • feature_image_caption — caption for the cover image associated with the page (supports basic html)
  • featured — indicates a featured page, defaults to false
  • pagetrue if the post is a static page, defaults to false
  • meta_title — custom meta title for the page
  • meta_description — custom meta description for the page
  • published_at — date and time when the page was published
  • updated_at — date and time when the page was last updated
  • created_at — date and time when the page was created
  • primary_author — a formatted link to the first author. See Authors for more information
  • tags - a list of tags associated with the page

Helpers

Using the {{#post}}{{/post}} block expression is used to theme a static page. Once inside of the page, you can use any of these useful helpers (and many more) to output your page’s data:

{{title}}, {{content}}, {{url}}, {{author}}, {{date}}, {{excerpt}}, {{img_url}}, {{post_class}}], {{tags}}.

<!-- page.hbs -->

<!-- Everything inside the #post tags pulls data from the static page -->
{{#post}}

<article class="{{post_class}}">
  <header class="page-header">
    <h1 class="page-title">{{title}}</h1>
    <section class="page-meta">
      <time class="page-date" datetime="{{date format='YYYY-MM-DD'}}">
        {{date format="DD MMMM YYYY"}}
      </time>
      {{tags prefix=" on "}}
    </section>
  </header>
  <section class="page-content">
    {{content}}
  </section>
</article>

{{/post}}