Hedwik/Skalven

Routes Setup

Upload the theme's routes.yaml to unlock its full page structure and custom layouts. This step is required for the theme to work correctly.

The theme will not function correctly until routes.yaml is uploaded and active. Without it, some pages may appear blank or fall back to Ghost's default layout.

Your theme package includes a routes.yaml file that maps the theme's custom pages and collections to the right templates. Uploading it is a required setup step.

Uploading routes.yaml

  1. In your Ghost Admin, go to Settings → Labs.
  2. Under Beta features, find the Routes section.
  3. Click Upload routes file and select the routes.yaml file from your unzipped theme package.
  4. Refresh your homepage to confirm the new structure is live.

Uploading a routes file replaces your current routing configuration. If you have customized routes before, back up your existing routes.yaml first.

What routes.yaml Does

  • Registers the theme's custom pages (such as the Articles and Podcasts templates).
  • Maps collections and filters to the correct templates.
  • Enables the optimized URL structure the theme is built around.

Note: You only need to upload routes.yaml once. Re-upload it only if you switch themes or receive an updated file in a theme update.

Install Theme

Thank you for choosing Skalven. Follow the steps below to install your theme, then head to Routes Setup to finish configuration.

Logos

Set up your site's logos. This theme uses an advanced logo system that gives you flexible control over how your brand appears across the site.

On this page

Uploading routes.yamlWhat routes.yaml Does