Getting started

Building a site in the editor

You don't have to write a template to make a Verso site. Everything below happens in the browser, and every piece it makes is a plain file a developer can open later.

A new site from npx verso-cms new is made of blocks: a shared header and footer, and pages built from a hero, text, features, a team, a quote, latest posts, a list of tags and more. From there, you can build the rest without opening a file.

Name the site

Open Site settings from the bar. Set the site's name, the address it will live at, a sub-folder if it won't be at the root of its domain, its language, and whether to make a search index. When you change the name, Verso offers to change it in the shared header and footer too.

Set the look

Open Design. Click a colour to change it, rename it or see where it's used. Give each text size a phone size and a wide-screen size. The Text tab sets how articles look: paragraphs, headings, links, quotes, code and tables, each with a live sample. Every choice is one of the site's tokens, so the site stays consistent.

Change the header and footer

The header and footer are blocks in shared block areas, the same on every page. Click the site's name or a menu link on any page to change it, and every page changes. Use Add to Links under the menu for a new link, and set its address in the Links to box.

Build your own blocks

Open Build a block. Start from scratch or from a copy of a block you have, add pieces, and style them with the site's tokens:

  • Words and pictures: headings, text, rich text, images, links, buttons, quotes, and fixed words that are the same wherever the block is used.
  • A list of pages: pick a folder, an order and how many. Filter by tag or by a field, split it into pages, leave out the page it's on, and write the words to show when there are none. Inside each item, add its title, date, description, image, tags or link.
  • A list of items: a team, questions and answers, steps. Name the list, and writers add items with Add to People.
  • Show only when: show a piece only when a field is filled in, empty, or has a certain value, with something else to show otherwise.
  • More: a count of pages, this page's title, date, description and tags, text on every page, and a block area for blocks inside the block.
  • Grids with a number of columns for phones, tablets and desktops.

Page types

A page type decides a page's shape. Make a new one from the New page dialog, the site view or Site settings, starting from an existing type. To give new pages a starting layout, set a page up the way you like, open Page settings, and choose Start new pages like this one under Page type. New pages of that type, including new posts in a channel, start with the same blocks, without the words. It's kept in templates/<type>.layout.json.

Channels and tags

Open Channels and choose Make a channel to turn a folder into a journal, a portfolio or anything that grows. Pick what one item is called and which page type new items use. A new folder's page already lists its items. See Channels.

Give pages tags in Page settings. To list them, make a page, open its Page settings, and under Advanced choose a folder in Make this a tag page, listing the tags of. It becomes the tags page: the list of every tag, with a page for each tag beneath it. Verso offers to add the Tag list and Tagged posts blocks to show them. See Tags and tag pages.

Publish

Press Publish. Verso saves a restore point with a message that says what changed, and pushes it when the site is connected to a repository. See Publishing.