Skip to content

Published site SEO

Topicary automatically handles the technical SEO for your published site. This guide explains what's generated, what you control, and how to get the most out of it.

What Topicary generates automatically

Open Graph images

Every published page gets a unique OG image (1200x630 JPEG) generated at publish time. The image uses a deterministic gradient pattern seeded from the page title, so each page has a distinct visual identity when shared on social media, Slack, or other platforms that display link previews.

OG images are regenerated each time you publish. Unpublishing a site removes its OG images.

Meta tags

Each page includes:

  • <title> — "Page Title — Site Name"

  • <meta name="description"> — "Page Title — Site Name documentation"

  • og:title, og:description, og:image — for Facebook, LinkedIn, Slack, and other platforms

  • twitter:card — summary_large_image with title, description, and image

  • og:type — article

Here is an example of the meta tags generated for a page titled "Getting Started" on a site called "Acme Docs":

<title>Getting Started — Acme Docs</title>
<meta name="description" content="Getting Started — Acme Docs documentation">
<meta property="og:title" content="Getting Started — Acme Docs">
<meta property="og:description" content="Getting Started — Acme Docs documentation">
<meta property="og:image" content="https://acme-docs.topicary.com/og/getting-started.jpg">
<meta property="og:type" content="article">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Getting Started — Acme Docs">
<meta name="twitter:description" content="Getting Started — Acme Docs documentation">
<meta name="twitter:image" content="https://acme-docs.topicary.com/og/getting-started.jpg">

Write clear, descriptive topic titles since they directly become your <title> and og:title values. A title like "Configure SSO with Okta" will perform better in search results and look more compelling in link previews than a generic title like "Authentication Settings."

robots.txt

Your published site serves a robots.txt that allows search engines to crawl all published content. Dashboard routes (/projects/, /login, /signup) and API endpoints are blocked.

XML sitemap

An XML sitemap at /sitemap.xml lists all published pages for search engine discovery.

Clean URLs

Pages use slug-based URLs derived from topic titles — for example, setting-up-sso for a topic titled "Setting Up SSO." No query parameters, no file extensions.

What you control

Topic titles directly become page titles, OG titles, and the primary SEO signal. Write clear, descriptive titles that match what your readers search for.

Topic content is indexed by search engines. Front-load key information in the first paragraph — search engines and AI tools weight early content more heavily.

Map hierarchy determines the URL structure and navigation. A well-organized map with logical nesting helps search engines understand content relationships.

Per-page meta descriptions are auto-generated from the title and site name. You cannot override them individually. If you need more control over how a page appears in search results, focus on writing a specific, descriptive topic title — it carries the most weight.

Tips for better SEO

  1. Use specific topic titles. "Configure SSO with Okta" ranks better than "Authentication Settings."

  2. One topic per concept. Focused pages rank better than long pages covering multiple subjects.

  3. Link between related topics. Internal cross-references help search engines discover and weight your content.

  4. Keep content fresh. Updated content ranks better. Use staleness indicators to identify topics that need review.

What's not configurable

  • Per-page meta descriptions — generated automatically from the title and site name

  • Canonical URLs — set automatically to the published page URL

  • OG image design — generated automatically using gradient patterns

  • robots.txt rules — fixed to allow public content and block dashboard routes

See also

Was this page helpful?