Posts per page

You can control how many posts are displayed on your homepage and archive pages, such as tags and authors. This setting is configured in the theme’s package.json file and doesn’t require any additional tools or local Ghost setup.

Change Posts per Page

Follow the steps below:

1

Unzip the Theme

• Unzip the theme sand.zip file on your computer.

2

Open package.json

• In the root folder of the theme, open the package.json file using a code editor like Visual Studio Code or Sublime Text.

3

Locate the config.posts_per_page Field

• Find the following line inside the file:

"config": {
  "posts_per_page": 8
}

4

Update the Value

• Change the number to your desired amount of posts per page.

• For example, to display 12 posts per page:

"config": {
  "posts_per_page": 12
}

5

Save and Rezip the Theme

• After editing, save the file and compress the theme folder back into a sand.zip file.

6

Upload the Updated Theme

• In Ghost Admin, go to: Settings > Site > Theme > Change theme > Upload Theme yoursite.com/ghost/#/settings/theme

Recommended Tools

To safely edit the theme files, always use a code editor that supports UTF-8 encoding and JSON formatting, such as:

• Visual Studio Code

• Sublime Text

Avoid using basic text editors like Notepad or word processors like Word — they can break the file structure, add hidden characters, or corrupt encoding, which may cause errors when uploading the theme.