Skip to Content
DocsOnFlowCustom Pages URLs

Custom Pages URLs

The OnFlow theme includes several types of built-in pages. This guide explains how to customize these pages and manage their navigation links throughout your site.

Built-in Pages Overview

The theme includes two types of built-in pages:

Pages with Custom Routes

These pages are defined in routes.yaml:

  • Sign-in (/signin/)
  • Sign-up (/signup/)
  • Writings (/writings/)
  • Projects (/projects/)

Pages with Predefined Templates

These pages use custom templates and require creation in Ghost admin:

  • Authors (/authors/)
  • Membership (/membership/)
  • Recommendations (/recommendations/)
  • Tags (/tags/)

Customizing Page URLs

Pages with Custom Routes

To modify signin, signup, or writings pages, you need to update the Ghost routes configuration:

  1. Download your current routes.yaml file from Ghost admin
  2. Modify the routes to your desired URLs: 
     routes:
     # Original
     /signup/:
         template: signup
     /signin/:
         template: signin
 
     # Example of custom URLs
     /login/:
         template: signin
     /join/:
         template: signup
 collections:
     # Original
     /writings/:
         permalink: /{slug}/
         filter: 'tag:-hash-project'
         template: writings
     /projects/:
         permalink: /{slug}/
         filter: 'tag:hash-project'
         template: projects
 
     # Example of custom URLs
     /posts/:
         permalink: /{slug}/
         filter: 'tag:-hash-project'
         template: writings
     /works/:
         permalink: /{slug}/
         filter: 'tag:hash-project'
         template: projects
  3. Save the file and upload it back to Ghost admin

Pages with Predefined Templates

For pages using predefined templates (authors, membership, recommendations, and tags), follow these steps:

  1. Rename the respective template file in your theme folder:
    • page-authors.hbs → page-your-new-slug.hbs
    • page-membership.hbs → page-your-new-slug.hbs
    • page-recommendations.hbs → page-your-new-slug.hbs
    • page-tags.hbs → page-your-new-slug.hbs
  2. Update the page URL in Ghost admin to match your new slug

The theme includes built-in links to some pages in various templates. You can manage these links through the locales file, but the behavior differs depending on the page type.

Some links can be completely removed from theme templates by setting them to "false" in /locales/en.json:

{
  "/recommendations/": "false",
  "/projects/": "false",
  "/writings/": "false"
}

Authentication and membership-related links cannot be completely removed. When set to "false", they fall back to Ghost’s default Portal links:

{
  "/signin/": "false",    // Falls back to #/portal/signin
  "/signup/": "false",    // Falls back to #/portal/signup  
  "/membership/": "false" // Falls back to #/portal/account
}

This ensures users can still access essential authentication features even when custom pages are disabled.

To update the URLs of these links, modify /locales/en.json:

{
  "/signin/": "/login/",
  "/signup/": "/join/",
  "/recommendations/": "/my-picks/",
  "/projects/": "/works/",
  "/writings/": "/posts/",
  "/membership/": "/subscribe/"
}

Removing Pages

Pages with Custom Routes

  • Remove the corresponding route from the routes.yaml file
  • Note: Authentication links (/signin/, /signup/) will fall back to Ghost Portal even when removed from locales

Pages with Predefined Templates

  • Delete the corresponding page in Ghost admin
  • For non-authentication pages, you can completely remove links using the locales file
Contact PageDefault Templates