---
title: "Getting Started Routes Setup"
description: "Scope Ghost theme comes with routes.yaml for a blog and routes-landing.yaml, which puts a landing page at the root and moves posts to /blog/."
url: "https://www.priority.vision/docs/scope/getting-started-routes-setup"
scope: theme
appliesTo: [Scope]
lastUpdated: 2026-10-23
---

# Routes Setup

To upload the `routes.yaml` follow these steps:

1. Unzip the scope.zip theme file
1. Go to **Settings → Advanced → Labs**
1. Click **Open → Beta features**
1. Under **Routes** section, click **Upload routes file** button
1. Select and upload the `routes.yaml` file from the theme folder

![Ghost routes settings](https://www.priority.vision/images/docs/common/routes-settings.png)

    Note: upload `routes.yaml` after uploading the theme zip.<br />
    There will already be a default `routes.yaml` file uploaded to Ghost. You must upload your theme's `routes.yaml` to override the default.

    Do this separately after uploading your theme zip file.

## Available Routes Files

Scope comes with multiple routes configuration files:

### Default Routes (`routes.yaml`)

The standard configuration for a simple blog setup:

```yaml
routes:
  # A channel lists every post without taking them from the "/" collection.
  /blog/:
    controller: channel
    template: blog
    # data: page.blog # When active data will be taken from the  "/blog/" page

collections:
  /:
    permalink: /{slug}/
    template: index

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

The `/blog/` route is where the **View All** button under **Latest Posts** on the home page leads.

### Landing Page Routes (`routes-landing.yaml`)

Use this configuration to enable the landing page feature:

```yaml
routes:
  /:
    template: landing
  /home/:
    template: home

collections:
  /blog/:
    permalink: /{slug}/
    template: blog

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

    **Important:** When using the landing page routes, your blog posts will be available at `/blog/` instead of the root URL.

## Enabling the Landing Page

To enable the landing page feature:

1. Rename `routes-landing.yaml` to `routes.yaml` (or copy its contents)
1. Upload the file to Ghost as described above
1. Create landing sections by following the [Landing Page documentation](/docs/scope/landing-page)

## Custom Pages Data

Our theme provides a few custom pages. However, to modify the page title, image, excerpt, and content, you need to activate the `data` property. To do so, you must remove the `#` symbol in front of the data property in the `routes.yaml` file. Then, create the page with the correct slug that you wish to control.

    **Important:** If you do not uncomment the `data` property in `routes.yaml` and upload the file to Ghost, the custom page will not use your page title, feature image, or excerpt. It will use the default theme settings.

## Documentation Index
> Fetch the complete documentation index at: https://www.priority.vision/docs/scope/llms.txt
> Use this file to discover all available pages before exploring further.