How to Create an Authors Page in Your Ghost Theme
An authors page lists the writers on your Ghost site. Readers can find them in one place.
In this post, I will show you how to add a custom authors page to your Ghost theme. The screenshots show an earlier version of Casper. This example uses that version’s HTML classes and partial names. The Ghost helpers apply to other themes, but you will need to adapt the markup to your theme.
The query below returns up to 100 authors who have published posts. For a larger directory, use the get helper’s page option to fetch more results.
Create the Authors Page Theme File
Create a file named custom-authors.hbs in your theme directory. Copy the following code into it.
{{!< default}}
<header class="site-header">
<div class="outer site-nav-main">
<div class="inner">
{{> "site-nav"}}
</div>
</div>
</header>
{{#post}}
<main id="site-main" class="site-main outer" role="main">
<div class="inner">
<header class="post-full-header">
<h1 class="post-full-title">{{title}}</h1>
</header>
{{#get 'authors' limit='all' include='count.posts' order='count.posts desc'}}
<div class="post-feed">
{{#foreach authors}}
<article class="post-card {{#unless profile_image}} no-image{{/unless}}">
{{#if profile_image}}
<a class="post-card-image-link" href="{{url}}">
<div class="post-card-image" style="background-image: url({{profile_image}})"></div>
</a>
{{/if}}
<div class="post-card-content">
<a class="post-card-content-link" href="{% raw %}{{url}}">
<header class="post-card-header">
<h2 class="post-card-title">{{name}}</h2>
</header>
<section class="post-card-excerpt">
<p>{{bio}}</p>
</section>
</a>
</div>
</article>
{{/foreach}}
</div>
{{/get}}
</div>
</main>
{{/post}}
The #get helper fetches the authors. The include attribute adds their post counts. The order attribute sorts the authors by those counts.
The foreach helper loops through the authors. For each author, it shows a profile image, name, URL, and bio.
After adding the template, upload and activate the updated theme. On a self-hosted production site, you may edit the files directly. Restart Ghost after that edit. The template should then appear in the dropdown.
Create the Authors Static Page
- Create a new page and call it Authors, for example.
- From
Page settings, choose theAuthorstemplate from theTemplatedropdown. - Click Publish to publish the page.
This is an initial example of what you can do with an authors page. You can extend it with each author’s social accounts, location, cover image, and post count. For example, see the authors page in the Nubia theme. You can also add the authors page link to the site navigation.
See the official Ghost documentation. Its author-context reference lists the available author attributes.
More from the Blog
Latest Ghost Themes
Arish
For visual magazines that lead with photography, film, and selected stories.
Siwa
A personal publication that introduces the writer before inviting readers into the stories.
Hanoi
An image-led magazine for creative stories, rich navigation, and long-form reading.
Taba
A newsroom front page for coverage across topics, video, and story formats.
Marsa
A flexible publication homepage for featured stories, topics, and newsletters.
Hakone
For writers who want readers to browse complete posts on the homepage.