Posts per page

The Caards theme allows you to control how many posts appear per page on your homepage and archive pages such as tags and authors.

This setting is managed in the theme’s package.json file and does not require installing any dependencies or running Ghost locally.

Change Posts per Page

Follow the steps below:

1

Unzip the Theme

• Unzip the theme caards.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": 10
  }

4

Update the Value

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

• For example, to display 16 posts per page:

  "config": {
    "posts_per_page": 16
  }

5

Save and Rezip the Theme

• After editing, save the file and compress the theme folder back into a caards.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.