2 min read

Chapter 1.6.0

Chapter 1.6.0
Chapter 1.6.0 introduces Ghost 6 support, additional post metadata, and updates to chapter navigation for Ghost’s API limits.

Chapter 1.6.0 introduces Ghost 6 support, additional post metadata, and updates to chapter navigation for Ghost’s API limits.

Chapter 1.6.0 is a compatibility release for Ghost 6.0 and later. If your site is still on Ghost 5, upgrade Ghost first, then upload this theme version. Chapter 1.6.0 will not run on Ghost 5.

Ghost 6 support

Ghost 6 changes how themes fetch data from the Content API. The most relevant change for Chapter is that {{#get}} requests can return at most 100 items — the old limit="all" option is gone.

I have updated every place in the theme that relied on limit="all":

  • Chapter sidebar navigation — the order-tag tree and the posts listed under each section are each capped at 100 items. Previous/next links at the bottom of a chapter post are built from that sidebar data, so both lists need to be complete for navigation to work correctly.
  • Popular topics — sidebars now fetch the top five tags by post count directly, with the same result as before but without loading every tag on your site.
  • Featured posts on author pages — capped at 100 featured items in the sidebar.

For most serials — documentation, course chapters, issue archives — this is plenty of headroom. If you are building something with more than 100 sections or more than 100 posts under a single section, get in touch; that would need a bespoke approach.

To upgrade Ghost itself, follow the official major version update guide. Your host will need Node.js 22 for Ghost 6.

Improvements

Additional post metadata

Posts can now output extra information in the page <head>:

  • An author meta tag when the Show author theme setting is enabled.
  • A publish date meta tag (og:publish_date) with the post’s published timestamp.

Useful for syndication, SEO tooling, and anything that reads document metadata outside the visible post body.

Upgrading from 1.5.0

  1. Back up your site, then upgrade Ghost to the latest 5.x and then to the latest Ghost 6.x.
  2. Obtain chapter.zip from your purchase download or a fresh build of this release.
  3. In Ghost Admin, go to Settings → Design, upload the zip, and activate Chapter 1.6.0.

Your existing posts, theme settings, and chapter tagging setup are unchanged — no reconfiguration required after upload.