Skip to main content

Journal Page — Content Reference

CMS Path: Pages → Journal

File: content/journal.md

The Journal Page is a controller — it does not contain articles itself. It lists articles from the Blog Posts collection.

python ssg pro jamstack static site generator

Page Metadata​

FieldFile KeyWhat It Controls
LayoutlayoutTemplate used (do not change)
TitletitleBrowser tab and SEO title
DescriptiondescriptionMeta description
ImageimageSocial share image
KeywordskeywordsSEO keywords

Collection Settings​

FieldFile KeyWhat It Controls
CollectioncollectionWhich collection to list (default: posts)
PaginationpaginationNumber of posts per page
Sort Bysort_byField to sort by (default: date)
Sort Ordersort_orderasc or desc

What Each Setting Does​

  • Collection — tells the controller where to pull items from. Default is posts. Change this only if you rename the collection folder.
  • Pagination — how many posts appear on each page. Common values: 6, 9, 12.
  • Sort By — which field to sort by. Use date for newest first, or title for alphabetical.
  • Sort Order — desc puts newest first, asc puts oldest first.

How Pagination Works​

If pagination: 6 and you have 18 posts, the Journal page generates:

/journal/           → page 1 (posts 1–6)
/journal/page/2/    → page 2 (posts 7–12)
/journal/page/3/    → page 3 (posts 13–18)

The template automatically renders Previous and Next links.

python ssg pro jamstack static site generator

How to Edit the Journal Page​

  1. Open the CMS at /admin/
  2. Click Pages → Journal
  3. Edit the metadata
  4. Adjust pagination or sorting
  5. Click Save

To edit the articles themselves, go to Blog Posts in the sidebar.

Common Pagination Values​

Posts per PageBest For
4Featured-heavy journals
6Balanced (default)
9Content-rich blogs
12Magazine-style listing

Best Practices​

  • Set pagination to match your design — 6 works for most blogs
  • Use date + desc — newest first is expected
  • Do not rename the collection — keep posts
  • Write strong descriptions — this page appears in search results

Troubleshooting​

Journal page is empty​

  1. Check that content/posts/ contains Markdown files
  2. Confirm each post has valid frontmatter
  3. Check the collection value — it should be posts

Pagination does not appear​

  1. Check that pagination is set to a number greater than 0
  2. Confirm there are more posts than the pagination value
  3. Save and rebuild

Posts appear in the wrong order​

  1. Check sort_order — use desc for newest first
  2. Check that each post has a date field
  3. Confirm dates are in YYYY-MM-DD format

Wrong collection is listed​

Open collection and set it to posts. Do not change it unless you renamed the folder.

Old posts do not appear​

Check that old posts are not accidentally filtered out by a draft: true flag in their frontmatter.

What's Next?​

Now let's look at the Projects Page.

👉 Next: Projects Page →