Skip to Content
Meet our new project Fantasma: Create custom themes visually for Free.
DocsScopeGhost Config

Ghost Config

Ghost themes include a package.json file with predefined configuration. You can edit this file to change theme-level behavior like pagination and responsive image sizes.

Editing Theme Code is required to add these changes.

Posts per page

The posts_per_page value defines how many posts appear in the blog list before pagination. You can change it in the theme package.json file:

"config": { ... "posts_per_page": 8, ... }

Image sizes

Ghost can handle responsive image sizes, and this is defined in the package.json file, under the image_sizes property:

"config": { ... "image_sizes": { "140": { "width": 140 }, "200": { "width": 200 }, "400": { "width": 400 }, "600": { "width": 600 }, "1200": { "width": 1200 }, "2000": { "width": 2000 } }, ... }

The image sizes defined there will be used to generate copies of images at the specified sizes when uploading images in Ghost Admin.

Ghost(Pro) Users

If you’re using Ghost(Pro), most configuration is managed through the admin panel. Focus on:

  • Settings β†’ General for site settings
  • Settings β†’ Integrations for API access
  • Settings β†’ Code injection for custom code