Skip to main content
Every site comes with sitemaps, RSS feeds, canonical URLs, Open Graph tags and schema.org data, and the settings on this page fine-tune them. See AI agents and search for everything that’s automatic.

SEO

blog.json
seo.indexing: "all" does not make hidden pages discoverable. They stay out of public listings, sitemaps and generated AI indexes, even with a custom robots tag.

Share images

Posts and entries without an image get a generated 1200×630 share image with your site name, the section, the title and your brand color. The blog and changelog home pages get one too, with the section title, and their tag and author pages reuse it. Every setting below is also in the dashboard under Design → Share images, with a live preview of a post and a home page drawn by the same renderer as your builds. To use your own image for those pages instead, set seo.image:
blog.json
  • image is a path in public/ or an https:// URL. Use a 1200×630 PNG or JPEG, because not every link preview reads WebP, AVIF or SVG.
  • imageAlt describes it for screen readers.
  • Posts keep their own image or generated share image.
  • You can also set it in the dashboard under Design → Share images → Home page image.
blog.json
  • appearance is light (default) or dark.
  • background is a PNG, JPEG or SVG in public/ behind the text.
  • "enabled": false turns them off, and pages without an image then use seo.image, or else your logo.

Font

Share images use Inter. To use your brand font, add a TTF, OTF or WOFF file to public/ and point font at it:
blog.json
  • WOFF2 doesn’t work, because the renderer can’t read it. Most font sites offer a TTF download.
  • One file draws the whole image, so titles and labels share its weight. Pick the weight you want for titles.
  • Characters the font doesn’t have, like other scripts, fall back to Inter.
  • A file that’s missing or can’t be read leaves a warning in the build log, and the images use Inter.

Author layout

"layout": "author" puts your logo and a label on top, the title in the middle and the post’s first author at the bottom, with avatar, name and title, next to your domain:
blog.json
  • label replaces the section title in the top corner and shows in capitals.
  • The logo is logo (the light version) or else favicon. Use a PNG, JPEG or SVG in public/.
  • Avatars come from the author’s avatar in public/ as PNG, JPEG or SVG. A WebP or remote avatar shows the logo instead.
  • In this layout, background spans the full width and the bottom half of the image, so a 1200×315 image fits exactly.

Article layout

Sites set up with the Notra starter begin on this layout. "layout": "article" puts the date and a category on top, the title below, and the post’s description and authors at the bottom:
blog.json
  • The category is the post’s first tag, else label, else the section title.
  • The date drops the year for posts from the current year.
  • All authors show with overlapping avatars. Authors without a usable avatar get their initial on your brand color.
  • Entries without authors, like changelog entries, show your logo and domain instead.
  • background covers the whole image.

404 page

Set the title and text of the 404 page under Design → 404 page in the dashboard, or in blog.json:
blog.json
The description supports Markdown links, **bold**, *italic* and `code`. The page uses your site’s header, footer, colors and fonts. A path outside every section, like /pricing on a site with only /blog, shows the blog’s 404 page. With "redirect": true, an unknown page sends readers to the blog or changelog home instead of showing the 404 page, while search engines still get a 404 status.

Redirects

Redirects let you move or rename a post without breaking links.
blog.json
  • source is a full path on your domain, including the section path, like /blog/old-post.
  • A source ending in /* matches every path below it, and when destination also ends in /*, Notra carries the rest of the path over.
  • A segment like :slug in source matches any one segment, and destination can use the same :slug anywhere, like /blog/:slug or /og/:slug.png. Names start with a letter or underscore and contain letters, digits and underscores. A placeholder in source has to be a whole segment, and each name can only appear once in it, or the build stops. A :name in destination that source doesn’t define stays as written, like Special:Search, and a :segment in source with an invalid name only matches literally. The build shows a redirect_placeholder warning for both in case it’s a typo.
  • Placeholders work together with /*: { "source": "/old/:section/*", "destination": "/new/:section/*" } sends /old/guides/setup to /new/guides/setup.
  • destination is a path or an https:// URL.
  • permanent is true by default (308), so set it to false for a temporary redirect (307).
  • Rules are checked in order and the first matching rule wins, so put specific rules before placeholders and /*. Redirects win over existing pages. Notra doesn’t carry query strings over, and a site can have up to 500 rules.

Dates

"metadata": { "timestamp": false } hides the “Updated” date on posts, while the sitemap still tells search engines when a post changed.
Last modified on November 8, 2026