Documentation

Learn how to install, customize, and use Verse with this documentation.

Installation

To install Verse:

  1. Download the theme ZIP file.
  2. Log in to your Ghost Admin.
  3. Go to Settings → Theme → Change theme.
  4. Upload the theme ZIP file and activate Verse.
  5. Upload the included routes.yaml via Settings → Labs → Routes.
Note: Verse requires routes.yaml to enable the Articles archive.

Manage your navigation links from Settings → Navigation.

Primary navigation

Manage the main navigation links displayed in the site header.

Secondary navigation

Manage the secondary navigation links displayed in the site footer.

Social accounts

Manage the social links displayed in the footer from Settings → Social accounts.

Design & branding

Go to Settings → Design & branding.

Brand

Use Ghost's brand settings to customize your publication's visual identity.

  • Accent color: Used for buttons, links, and other interactive elements.
  • Social icon: Upload a custom icon for your publication.
  • Logo: Upload your publication logo to display it in the site header.
  • Typography: Choose the font pairing used by the theme. By default, Verse uses Merriweather for headings and body text.
Note: Verse does not use the Publication cover image.

Homepage

Customize the homepage hero section.

  • Hero title: The main heading.
  • Hero subtitle: Supporting text displayed below the title.
  • Hero action:
    • Subscribe: Displays a newsletter subscription form.
    • Button: Displays a custom button.
    • None: Displays only the title and subtitle.

When Button is selected, the following options become available:

  • Hero button text: The button label.
  • Hero button URL: The button destination URL.

The homepage displays up to 3 featured articles, followed by the 6 most recent articles, excluding featured posts.

Post

Show recent posts footer: Show or hide a list of recent posts at the end of each article.

Site Wide

Show signup form: Show or hide the newsletter signup form above the site footer.

Localization

Verse includes theme translations for the following languages:

  • English (en)
  • Spanish (es)
  • French (fr)
  • German (de)

To change the theme language, go to Settings → General → Publication Language and select one of the supported languages.

Note: If a language is not available, Ghost falls back to English.

Development

To work with the theme source files, you need Node.js installed.

Install the dependencies:

npm install

Start the development watcher:

npm run dev

Edit the source files in assets/css/. Changes are compiled automatically to assets/built/.

To generate a production theme ZIP:

npm run zip

This generates dist/verse.zip, ready to upload to Ghost.

Note: If you modify the theme source files, future updates may overwrite your changes. Keep a backup of your customizations before updating.

SVG Icons

Verse uses free Font Awesome SVG icons as Handlebars partials.

Icons are located in partials/icons/.

Changelog

See the changelog for a list of changes and updates in each version.

Support

Need help with Verse?

contact@webvy.xyz