SEO

Sitemaps, indexing rules, and social share images

The engine handles most SEO for you — canonical URLs, meta tags, and per-page social images are generated automatically. A couple of settings are worth knowing about.

siteUrl & sitemap

Set siteUrl to your site's public URL. It's used for the sitemap, canonical links, and absolute URLs in social cards:

{ "siteUrl": "https://docs.acme.com" }

Without siteUrl, the sitemap is served empty and robots.txt won't link to it. fiskil validate and fiskil doctor warn you when it's missing.

robots & noindex

Keep specific path prefixes out of search engines. They're excluded from the sitemap and marked noindex:

{
  "seo": {
    "noindex": ["/internal", "/es"]
  }
}

Social images

Every page gets an Open Graph image generated from its title and your brand color, so links unfurl nicely in Slack, iMessage, and social. Set a site-wide default with ogImage (a path under public/) if you'd rather use your own:

{ "ogImage": "/og/default.png" }

Next: add your API

Turn an OpenAPI file into a live reference.