Jekyll Themes •
Last updated: January 20, 2026

Tokyo Theme Author Management

Tokyo Jekyll Theme

Table of Contents

The Tokyo theme supports multiple authors, allowing you to create author profiles and assign posts to specific authors. This guide explains how to manage authors effectively.

Author System Overview

The author system in Tokyo theme works through:

  1. Author Profiles: Individual HTML files in the _authors/ folder
  2. Post Assignment: Linking posts to authors via author_id
  3. Author Pages: Automatically generated pages for each author

Creating Author Profiles

Step 1: Create Author File

Author profiles are stored as HTML files in the _authors/ folder. Each author needs a unique file.

File Naming Convention: Use the author’s name or ID as the filename

  • Example: john-doe.html, jane-smith.html, author-1.html

Step 2: Author File Structure

Create a new file in _authors/ with the following structure:

---
layout: author
name: John Doe
author_id: 1
email: john@example.com
bio: John is a web developer with 5+ years of experience in creating modern web applications.
image: /assets/img/authors/john-doe.jpg
location: San Francisco, CA
facebook: https://facebook.com/johndoe
twitter: https://twitter.com/johndoe
instagram: https://instagram.com/johndoe
linkedin: https://linkedin.com/in/johndoe
---

Author File Properties

Required Fields:

  • layout: Must be “author”
  • name: Author’s display name
  • author_id: Unique numeric ID (1, 2, 3, etc.)
  • email: Author’s email address
  • bio: Short biography
  • image: Path to author photo

Optional Fields:

  • location: Author’s location
  • facebook: Facebook profile URL
  • twitter: Twitter profile URL
  • instagram: Instagram profile URL
  • linkedin: LinkedIn profile URL
  • website: Personal website URL
  • github: GitHub profile URL

Example Author Profile

File: _authors/john-doe.html

---
layout: author
name: John Doe
author_id: 1
email: john@example.com
bio: John is a full-stack developer specializing in React and Node.js. He loves building scalable web applications and sharing knowledge through writing.
image: /assets/img/authors/john-doe.jpg
location: San Francisco, CA
facebook: https://facebook.com/johndoe
twitter: https://twitter.com/johndoe
instagram: https://instagram.com/johndoe
linkedin: https://linkedin.com/in/johndoe
github: https://github.com/johndoe
website: https://johndoe.com
---

Assigning Authors to Posts

Step 1: Add Author ID to Post

In the front matter of your blog post, add the author_id field:

---
layout: post
title: "Your Post Title"
date: 2026-01-20 10:00:00 +0600
post_image: /assets/img/news/1.jpg
tags: [tag1, tag2, tag3]
categories: [category-name]
author_id: 1
comments: true
excerpt: "Brief description of your post..."
---

Step 2: Verify Author ID Match

Ensure the author_id in your post matches the author_id in the author profile file.

Post:

author_id: 1

Author Profile:

author_id: 1

Example Post with Author

File: _posts/2026-01-20-getting-started-with-jekyll.md

---
layout: post
title: "Getting Started with Jekyll"
date: 2026-01-20 10:00:00 +0600
post_image: /assets/img/news/jekyll.jpg
tags: [Jekyll, Tutorial, Web Development]
categories: [Tutorials]
author_id: 1
comments: true
excerpt: "Learn how to set up your first Jekyll site and start creating static websites."
---

# Getting Started with Jekyll

Jekyll is a powerful static site generator...

[Post content]

Managing Multiple Authors

Creating Multiple Author Profiles

Create separate HTML files for each author in _authors/:

Author 1: _authors/john-doe.html

---
layout: author
name: John Doe
author_id: 1
email: john@example.com
bio: Full-stack developer with 5+ years of experience.
image: /assets/img/authors/john-doe.jpg
location: San Francisco, CA
---

Author 2: _authors/jane-smith.html

---
layout: author
name: Jane Smith
author_id: 2
email: jane@example.com
bio: UI/UX designer passionate about creating beautiful interfaces.
image: /assets/img/authors/jane-smith.jpg
location: New York, NY
---

Author 3: _authors/bob-wilson.html

---
layout: author
name: Bob Wilson
author_id: 3
email: bob@example.com
bio: Content strategist and technical writer.
image: /assets/img/authors/bob-wilson.jpg
location: Austin, TX
---

Assigning Posts to Different Authors

# Post by John Doe
---
author_id: 1
---

# Post by Jane Smith
---
author_id: 2
---

# Post by Bob Wilson
---
author_id: 3
---

Author Images

Preparing Author Images

  1. Recommended size: 400x400px or square format
  2. Format: JPG, PNG, or WebP
  3. Optimization: Compress images for web
  4. Naming: Use consistent naming convention

Storing Author Images

Create a folder for author images:

assets/
└── img/
    └── authors/
        ├── john-doe.jpg
        ├── jane-smith.jpg
        └── bob-wilson.jpg

Image Path Reference

In author profile files, reference images relative to the site root:

image: /assets/img/authors/john-doe.jpg

Author Page Customization

Author Layout

The author page layout is defined in _layouts/author.html. You can customize it to display:

  • Author photo and name
  • Author bio
  • Social media links
  • List of author’s posts
  • Contact information

Customizing Author Page Display

Edit _layouts/author.html to modify how author information is displayed:

<div class="author_profile">
    <img src="" alt="2026-01-20-tokyo-author-management.md" />
    <h1>2026-01-20-tokyo-author-management.md</h1>
    ......
</div>

Displaying Author Information on Posts

Post Layout Author Section

The post layout (_layouts/post.html) typically includes author information. Ensure it’s configured to display:

<div class="post_author">
    
</div>

Supported Social Platforms

The Tokyo theme supports these social media platforms:

  • Facebook
  • Twitter
  • Instagram
  • LinkedIn
  • GitHub
  • Website
  • YouTube
  • Dribbble
  • Behance

Add social media URLs to the author profile:

---
layout: author
name: John Doe
author_id: 1
email: john@example.com
bio: Full-stack developer with 5+ years of experience.
image: /assets/img/authors/john-doe.jpg
location: San Francisco, CA
facebook: https://facebook.com/johndoe
twitter: https://twitter.com/johndoe
instagram: https://instagram.com/johndoe
linkedin: https://linkedin.com/in/johndoe
github: https://github.com/johndoe
website: https://johndoe.com
youtube: https://youtube.com/@johndoe
dribbble: https://dribbble.com/johndoe
behance: https://behance.net/johndoe
---

Author Management Best Practices

  1. Unique Author IDs: Ensure each author has a unique numeric ID
  2. Consistent Naming: Use consistent naming for author files
  3. Quality Images: Use professional, high-quality author photos
  4. Complete Profiles: Fill out as much information as possible
  5. Accurate Bios: Write clear, concise author biographies
  6. Social Links: Include relevant social media links
  7. Regular Updates: Keep author information up to date
  8. Backup Profiles: Keep backups of author profile files

Troubleshooting

Author not displaying on post

Solution:

  • Verify author_id matches between post and author profile
  • Check that author file exists in _authors/
  • Ensure author file has correct front matter
  • Verify author layout is properly configured

Author image not loading

Solution:

  • Check image path is correct
  • Verify image exists in the specified folder
  • Ensure image file permissions are correct
  • Test image URL directly in browser

Author page not found

Solution:

  • Verify author collection is enabled in _config.yml
  • Check that author files have correct layout
  • Ensure author files are in the _authors/ folder
  • Verify permalink structure in configuration

Solution:

  • Verify URLs are complete (include https://)
  • Check for typos in URLs
  • Test links directly in browser
  • Ensure social media profiles are public

Posts not showing on author page

Solution:

  • Verify author_id matches in posts
  • Check that posts are published (not in future)
  • Ensure post layout is correct
  • Verify author page template logic

Advanced Author Features

Guest Authors

For guest authors who don’t have a full profile:

---
layout: author
name: Guest Author
author_id: 99
email: guest@example.com
bio: This is a guest author.
image: /assets/img/authors/guest.jpg
---

Author Categories

Categorize authors by role:

---
layout: author
name: John Doe
author_id: 1
email: john@example.com
bio: Full-stack developer with 5+ years of experience.
image: /assets/img/authors/john-doe.jpg
role: Developer
---

Author Statistics

Display author statistics (posts count, views, etc.):


<p>47 posts by 2026-01-20-tokyo-author-management.md</p>

Author Team Page

Create a team page displaying all authors:

<div class="team">
    
</div>

Author Management Examples

Example 1: Solo Blogger

---
layout: author
name: Sarah Johnson
author_id: 1
email: sarah@example.com
bio: Tech blogger and software engineer sharing insights on web development and programming.
image: /assets/img/authors/sarah.jpg
location: Seattle, WA
twitter: https://twitter.com/sarahjohnson
github: https://github.com/sarahjohnson
---

Example 2: Multi-Author Blog

Author 1 - Editor:

---
layout: author
name: Mike Chen
author_id: 1
email: mike@example.com
bio: Editor-in-chief with 10 years of publishing experience.
image: /assets/img/authors/mike.jpg
role: Editor
linkedin: https://linkedin.com/in/mikechen
---

Author 2 - Writer:

---
layout: author
name: Lisa Park
author_id: 2
email: lisa@example.com
bio: Tech writer specializing in tutorials and how-to guides.
image: /assets/img/authors/lisa.jpg
role: Writer
twitter: https://twitter.com/lisapark
---

Example 3: Company Blog

---
layout: author
name: TechCorp Team
author_id: 1
email: team@techcorp.com
bio: The TechCorp team shares insights on technology, innovation, and industry trends.
image: /assets/img/authors/techcorp.jpg
location: San Francisco, CA
website: https://techcorp.com
twitter: https://twitter.com/techcorp
linkedin: https://linkedin.com/company/techcorp
---

The Tokyo theme’s author management system makes it easy to manage multiple contributors and create a professional multi-author blog.