vara-404

The vara-404 template renders a self-contained not-found page with a large "404" backdrop, a short message, and a set of helpful links.

When to use it

Create one page with this template at /404.html:

{
  permalink: "/404.html",
  template: "vara-404",
  title: "Page not found",
  description: "The requested page could not be found.",
  sitemap: false,
  content: "",
}

The page sets noindex metadata and is excluded from the sitemap.

Configuring the links

The links on the page come from the not_found_links setting. The first valid entry is rendered as the primary action; the rest appear as secondary actions:

not_found_links:
  - title: "Go home"
    href: "/"
    icon: "house"
  - title: "Read the docs"
    href: "/docs/"
    icon: "book-open-text"

Each entry needs title and href, and may have an icon and new_tab. See Site settings for details.

Hosting notes

The page is produced as a static /404.html file. Most static hosts serve it automatically when a route is missing. If yours does not, configure the host to use 404.html as the custom error page.

Because hosts serve that file from any missing URL depth (for example example.com/nested/path/), the template resolves its stylesheet, scripts, and link URLs with vara_absolute_url instead of Veta's relative url() helper. Set site_url in your project so those URLs resolve to your domain; without it, assets fall back to root-relative paths.