Troubleshooting

Guidance for handling common issues and questions that may arise during use.

The error indicates that you are uploading the whole file downloaded from Themeforest.

After downloading the file – unzip it – on Windows (assuming that's the system you're using) you have to do it a certain way. Right-click on the archive you downloaded from Themeforest and select 'Extract All'. This will extract the files to your new location. This will give you access to theme files like e.g. theme-name.zip.

The best solution is to always use the same name e.g. theme-name.zip – that way you will not have to enter your settings again after uploading a theme.

Ghost assigns the settings in the 'Design & branding' section to the name of the uploaded archive. If you upload theme-v1.zip and theme-v2.zip – Ghost will recognize them as two different themes – so the settings will reset.

Note that the above instructions apply to the same theme, different themes have different custom settings, which are individual for each one.

The error indicates that there was previously used a routes.yaml file with another theme that required it. To solve the problem, reset the routes.yaml file to its default settings.

routes:
collections:
  /:
    permalink: /{slug}/
    template: index
taxonomies:
  tag: /tag/{slug}/
  author: /author/{slug}/

1. Go to the 'Labs' settings in the Ghost Admin to find the 'Routes' section.
2. 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}/