> For the complete documentation index, see [llms.txt](https://pinathemes.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pinathemes.gitbook.io/docs/breeze/advanced/posts-per-page.md).

# 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

{% stepper %}
{% step %}
Unzip the theme on your computer.
{% endstep %}

{% step %}
In the root folder, open `package.json` using a code editor (**Visual Studio Code**, **Cursor**, etc.).
{% endstep %}

{% step %}
Locate the `config.posts_per_page` field:

```json
"config": {
  "posts_per_page": 9
}
```

{% endstep %}

{% step %}
Change the value to the number of posts you want to display per page:

```json
"config": {
  "posts_per_page": 12
}
```

{% endstep %}

{% step %}
Save the file and compress the entire theme folder back into a ZIP file.
{% endstep %}

{% step %}
Upload the updated theme in Ghost Admin using (**Theme** → **Change theme** → **Upload theme**).
{% endstep %}
{% endstepper %}

### 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](https://code.visualstudio.com/)
* [Cursor](https://www.cursor.com/)

{% hint style="danger" %}
Avoid editors like Notepad or Word, as they may corrupt the JSON structure or introduce invalid characters.
{% endhint %}