Section Limits
Every list in the theme stops at a fixed number of items, so no section grows without limit as you publish. This page lists those numbers for each theme, says which of them are theme settings, and names the template file for the rest.
Unless a row says otherwise:
- A list shows the newest items first. When a new post qualifies for a list, the oldest one drops out on its own.
- A number without a setting is fixed in a template file. Code Injection cannot change it, because the posts are selected on the server when the page renders. Change the
limitvalue in the file named in the table and upload the theme again, as described in Editing Theme Code. posts_per_pageis the value inpackage.jsondescribed in Ghost Config.- Settings live in Settings → Site → Design & branding → Customize → Theme. The number after a setting name is its default.
Essence
Essence has one list and no featured section. A featured post gets a “Featured” label on its card and in the post header, and nothing else changes for it.
| Section | Shows | Change it |
|---|---|---|
| Posts list on the homepage, tag and author pages | 8 posts per page, then a Load More button | posts_per_page |
Scope
Homepage:
| Section | Shows | Change it |
|---|---|---|
| Featured section | The 10 newest featured posts, in every featured section style | home.hbs, limit=10 |
| Latest Posts | 8 posts per page | posts_per_page |
| Our Authors | The 6 authors with the most posts | home.hbs, limit=6 |
| Tag sections | The tags from the Tags list sections setting (3), 3 posts per tag in the Grid + Card Vertical post list style and 4 in the other styles | Tags Sections for the tags, home.hbs, limit=3 and limit=4 for the posts |
| Section | Shows | Change it |
|---|---|---|
| Featured Posts | The 10 newest featured posts | landing.hbs, limit=10 |
| Latest Posts | 8 posts per page | posts_per_page |
Posts and pages:
| Section | Shows | Change it |
|---|---|---|
| Related Posts under a post | The 3 newest posts other than the open one. They are not matched by tag. | post.hbs, limit="3" |
| Recommendations in the footer | 4 | partials/layout/footer.hbs, limit="4" |
| Tags in the footer | The Footer tags setting (4) | Tags |
| Tags page | The tags from the Tags page displaying tags setting (10), 3 posts per tag | page-tags.hbs, limit=3 |
| Authors page | Up to 100 authors, most posts first | page-authors.hbs, limit="100" |
Thoughts
Thoughts has no featured section and no related posts section. A featured post gets a flame icon on its card.
| Section | Shows | Change it |
|---|---|---|
| Posts list on the homepage, tag and author pages | 6 posts per page | posts_per_page |
| Recommendations in the popup navigation | 8 | partials/layout/popup-navigation.hbs, limit="8" |
| Tags page | The tags from the Tags page displaying tags setting (10) | Tags |
| Authors page | Up to 100 authors, most posts first | page-authors.hbs, limit="100" |
Feed
Feed has no featured section on the homepage. Featured posts appear in a sidebar widget, and a featured post gets a flame icon on its card. The widgets show in the layout styles that keep the sidebar widgets visible.
| Section | Shows | Change it |
|---|---|---|
| Posts list on the homepage, tag and author pages | 6 posts per page | posts_per_page |
| Featured widget | The 3 newest featured posts | limit="3" in default.hbs, author.hbs, page.hbs, page-tags.hbs and page-membership.hbs |
| Related Posts widget on a post | The 3 newest posts other than the open one. They are not matched by tag. | post.hbs, limit="3" |
| Recommendations widget | 5 | partials/widgets/recommendations.hbs, limit=5 |
| Tags widget | The Tags list widget setting (5) | Tags |
| Authors widget on an author page | The 3 other authors with the most posts | author.hbs, limit="3" |
| Tags page | The tags from the Tags page displaying tags setting (25) | Tags |
| Authors page | Up to 100 authors, most posts first | page-authors.hbs, limit="100" |
Moment
Featured posts have their own section only in the Tilt Flow home layouts. Everywhere else a featured post gets a flame badge on its card.
| Section | Shows | Change it |
|---|---|---|
| Gallery on the homepage, tag and author pages | 12 posts per page | posts_per_page |
| Hero gallery in the Tilt Flow and Tilt Flow Gallery layouts | The feature images of the 25 newest featured posts | partials/homes/tilt-flow.hbs, limit=25 |
| Tags on the homepage | The Tags list setting (10) | Tags |
| Read next under a post | The post published right before the open one | partials/sections/read-next.hbs, limit=1 |
| Tags page | The tags from the Tags page displaying tags setting (10), 4 posts per tag | page-tags.hbs, limit=4 |
| Authors page | Up to 100 authors, most posts first, 4 posts each | page-authors.hbs, limit="100" and limit=4 |
Aspect
Homepage:
| Section | Shows | Change it |
|---|---|---|
| Featured section, Carousel and Slider styles | The 8 newest featured posts | home.hbs, limit=8 |
| Featured section, Grid and Grid List styles | The 7 newest featured posts as one large card and six small ones. When fewer than 7 posts are featured, the empty cards take the newest non-featured posts. On narrower screens the grid hides its last cards to keep the rows even. | home.hbs, limit=7 |
| Latest | 12 posts, a Load More button for the next 12, then more load as you scroll | posts_per_page |
| Our Authors | The 10 authors with the most posts | home.hbs, limit=10 |
| Tag sections | The tags from the Tags list sections setting under Homepage (4), 10 posts per tag in a carousel | The setting takes the same values as Tags list. home.hbs, limit=10 for the posts |
| Recommendations | 12 | home.hbs, limit=12 |
| Tags | The Tags list setting (25) | Tags |
Posts and pages:
| Section | Shows | Change it |
|---|---|---|
| Read Next under a post | The 10 newest posts other than the open one, in a carousel. They are not matched by tag. | partials/post/read-next.hbs, limit=10 |
| Tags in the sidebar | The Tags list sidebar setting (4) | Tags |
| Tags page | The tags from the Tags page displaying tags setting (25), 10 posts per tag | page-tags.hbs, limit=10 |
| Authors page | Up to 100 authors, most posts first, 10 posts each | page-authors.hbs, limit="100" and limit=10 |
OnFlow
OnFlow has no featured section. A featured post gets an icon on its card. The homepage counts are settings, and an empty setting hides its section.
| Section | Shows | Change it |
|---|---|---|
| Latest posts on the homepage | The Latest posts count setting (5) | Sections |
| Projects on the homepage | The Projects count setting (3) | Sections |
| Recommendations on the homepage | The Recommendations count setting (4) | Sections |
| Tags on the homepage | The Tags list above posts setting (10) | Sections |
| Writings, Projects, tag and author pages | 8 posts per page | posts_per_page |
| Read next under a post | The 4 newest posts other than the open one. A project shows the 4 newest other projects instead. They are not matched by tag. | post.hbs, limit="4" |
| Tags page | The tags from the Tags page displaying tags setting (10) | Tags |
| Authors page | Up to 100 authors, most posts first | page-authors.hbs, limit="100" |
Thesis
Homepage and the Blog page template:
| Section | Shows | Change it |
|---|---|---|
| Featured, Paid and Latest sections on the homepage | 3 posts each. Featured shows the 3 newest featured posts, Paid the 3 newest paid posts, Latest the 3 newest posts | partials/sections/posts.hbs, limit=3, one value for all three sections |
| Featured and Paid sections in the Blog template | 3 posts each | The same limit=3 |
| Tags on the homepage | The Tags list setting (4) | Tags |
Sidebar, posts and pages:
| Section | Shows | Change it |
|---|---|---|
| Posts list in the sidebar | 10 posts, more load as you scroll | posts_per_page |
| Tags in the sidebar | The Tags list sidebar setting (5) | Tags |
| Tag filter above the sidebar list | Up to 100 public tags | default.hbs, limit="100" |
| Read next under a post | The 2 newest posts other than the open one. They are not matched by tag. | partials/post/read-next.hbs, limit="2" |
| Tags page | The tags from the Tags page displaying tags setting (10) | Tags |
| Authors page | Up to 100 authors | custom-page-authors.hbs, limit="100" |
Format
Homepage:
| Section | Shows | Change it |
|---|---|---|
| Featured section | The 20 newest featured posts, in every featured section style | home.hbs, limit="20" |
| Tags section | The Tags list above posts setting (10). The List with Posts style adds 4 posts per tag. | Tags for the tags, partials/section/tags.hbs, limit="4" for the posts |
| Latest | 6 posts per page | posts_per_page |
| Recommendations | The Recommendations count setting (4). Empty hides the section. | Sections |
Posts and pages:
| Section | Shows | Change it |
|---|---|---|
| Read next under a post | The 4 newest posts other than the open one. They are not matched by tag. | post.hbs, limit="4" |
| Writings page | 6 posts per page | posts_per_page |
| Tags page | The tags from the Tags page displaying tags setting (10), 4 posts per tag | partials/section/tags.hbs, limit="4" |
| Authors page | Up to 100 authors, most posts first, 4 posts each | page-authors.hbs, limit="100" and limit="4" |