Sign in

Documentation

Learn how to install, customize, and get the most out of Verse with this documentation.

Installation

Verse requires Ghost 6.x or later.

To install Verse:

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

Design & customization

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 theme font pairing. By default, Verse uses Merriweather Sans for headings and Merriweather for body text.
Note: Verse does not use the Publication cover image.

Theme

Homepage

Customize the homepage hero section.

  • Hero title — The main heading.
  • Hero subtitle — Supporting text displayed below the title.
  • Hero action — Choose the content displayed below the hero section:
    • 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 footer — Show or hide the newsletter signup form in the footer.

When enabled, you can customize the following options:

  • Signup heading — The form heading.
  • Signup subheading — Supporting text displayed below the heading.

Customize the content displayed in the site footer.

  • Footer navigation — Manage footer navigation links from Settings → Navigation → Secondary.
  • Footer social — Manage social links from Settings → Social accounts.

Localization

Verse includes 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 language codes.

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 server:

npm run dev

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

To generate a production-ready 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

For a complete list of changes in each release, see the changelog.

Support

Need help with Verse?

contact@webvy.xyz