@config

Specifically @config will pass through the special theme config that is added in the theme’s package.json so that it can be used anywhere in handlebars. At the moment, there is only one property which will be passed through, as all other properties are accessed with their own helpers.

{{@config.posts_per_page}} – the number of posts per page

Example Code

Standard usage:

<a href="{{page_url "next"}}">Show next {{@config.posts_per_page}} posts</a>

In the get helper limit field:

{{#get "posts" filter="featured:true" limit=@config.posts_per_page}}
  {{#foreach posts}}
      <h1>{{title}}</h1>
	{{/foreach}}
{{/get}}

Providing config

Config values can be provided by adding a config block to package.json

{
  "name": "my-theme",
  "version": 1.0.0,
  "author": {
    "email": "my@address.here"
  }
  "config": {
  }
}

There are currently four properties supported:

config.posts_per_page — the default number of posts per page is 5
config.image_sizes — see the assets guide for more details on responsive images
config.card_assets — configure the card CSS and JS that Ghost automatically includes
config.custom - add custom settings to your theme

Overview @custom

Getting Started

Core Concepts

Themes

Advanced Tools

Resources

Example Code

Providing config

​Example Code

​Providing config

Example Code

Providing config