Troubleshooting

Find solutions for common setup, upload, routing, and theme configuration issues that can appear while installing or updating your Ghost theme.

How to remove featured posts from the main collection

Go to the Labs settings in the Ghost Admin and scroll down until you see the Routes section.
Upload the routes.yaml file with these settings:

routes:

collections:
  /:
    permalink: /{slug}/
    filter: featured:false
    template: index
  /featured/:
    permalink: /featured/{slug}/
    filter: featured:true
    template: index

taxonomies:
  tag: /tag/{slug}/
  author: /author/{slug}/

This would set an additional /featured/ URL address for all posts that has been marked as featured. This change is required to remove those posts from the main collection.

The most important thing to know when working with .yaml is that it uses indentation to denote structure. That means the only type of nesting which works is 2 spaces. The most common reason for .yaml files not working is when you accidentally use the wrong type or quantity of spacing for indentation.