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 animage 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
imageis a path inpublic/or anhttps://URL. Use a 1200×630 PNG or JPEG, because not every link preview reads WebP, AVIF or SVG.imageAltdescribes it for screen readers.- Posts keep their own
imageor generated share image. - You can also set it in the dashboard under Design → Share images → Home page image.
blog.json
appearanceislight(default) ordark.backgroundis a PNG, JPEG or SVG inpublic/behind the text."enabled": falseturns them off, and pages without an image then useseo.image, or else your logo.
Font
Share images use Inter. To use your brand font, add a TTF, OTF or WOFF file topublic/ 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
labelreplaces the section title in the top corner and shows in capitals.- The logo is
logo(the light version) or elsefavicon. Use a PNG, JPEG or SVG inpublic/. - Avatars come from the author’s
avatarinpublic/as PNG, JPEG or SVG. A WebP or remote avatar shows the logo instead. - In this layout,
backgroundspans 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.
backgroundcovers the whole image.
404 page
Set the title and text of the 404 page under Design → 404 page in the dashboard, or inblog.json:
blog.json
**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
sourceis a full path on your domain, including the section path, like/blog/old-post.- A
sourceending in/*matches every path below it, and whendestinationalso ends in/*, Notra carries the rest of the path over. - A segment like
:sluginsourcematches any one segment, anddestinationcan use the same:sluganywhere, like/blog/:slugor/og/:slug.png. Names start with a letter or underscore and contain letters, digits and underscores. A placeholder insourcehas to be a whole segment, and each name can only appear once in it, or the build stops. A:nameindestinationthatsourcedoesn’t define stays as written, likeSpecial:Search, and a:segmentinsourcewith an invalid name only matches literally. The build shows aredirect_placeholderwarning for both in case it’s a typo. - Placeholders work together with
/*:{ "source": "/old/:section/*", "destination": "/new/:section/*" }sends/old/guides/setupto/new/guides/setup. destinationis a path or anhttps://URL.permanentistrueby default (308), so set it tofalsefor 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.