Key concepts
Learn the handful of terms Sonat uses everywhere, and how they fit together.
Sonat content is nested: an organization holds folders and documents, a document holds variants and languages, and each variant holds topics. Here's what each one means.
Organization
Your organization is your company's space in Sonat. It holds all your documents, your team, your plan and billing, and settings that apply everywhere, such as your logo, colors and custom domain. Readers reach your public help center at sonat.com/@your-organization, or at your own domain.
You can belong to more than one organization. Switch between them from the organization menu in the top bar.
Folder
A folder groups documents on Home, the same way folders group files on your computer. Folders can contain other folders. A folder's slug becomes part of the web address of everything inside it, for example sonat.com/@acme/routers/user-guide. Folders are optional. See Documents and folders.
Document (manual)
A document is one manual, help center or guide, with its own web address. When we say "manual", we mean a document. Each document has its own settings (title, theme, style and who can see it) and its own table of contents.
A document is a container. Creating one adds no content for readers. The content lives in its topics.
Topic
A topic is one page inside a document. Topics form the document's table of contents, and you can nest topics under other topics. Sonat has several topic types:
- Rich Text: a page you write in the text editor. Most topics are this type.
- Page: a visual page you build from ready-made components, such as a landing page.
- Google Doc: a topic you write in Google Docs and publish through Sonat.
Some types, such as Markdown and AI page, become available when you install their addon. A topic can also live on its own outside any document: a standalone topic. You create one from Create on Home and can link it into several documents. See Choose a topic type.
Variant
A variant is a parallel version of the same document, with its own table of contents and its own web address. Use variants for product versions (v1 and v2), editions (Basic and Pro) or audiences. Every document has at least one variant, the default variant, whose address is the document's address. Readers switch variants from a menu in the published document. See Variants.
Language
A document can be written in several languages. Each topic keeps a separate title and body per language, and readers pick their language in the published document. You add languages to the organization and to each document. See Add languages.
Draft and published
Everything you write is a draft first. Sonat saves your drafts automatically, and readers never see them. When you publish a topic, its current draft becomes the version readers see. You can keep editing the draft afterward without changing the live page until you publish again.
The table of contents marks topics that need publishing: a green plus for a topic that was never published, an orange mark for unpublished changes, and a red minus for a deletion that takes effect when you publish it.
If your organization uses approval, you send a Publish Request instead, and a reviewer publishes it. See Publish and preview.
Author and reader
- Authors are the people who write and edit in the editor. Each author has a role: Owner (one per organization, manages billing), Admin (manages settings and the team) or Writer (writes content). Plans include a number of authors.
- Readers read your published documents. Public documents are open to anyone. Private documents are open only to the readers you invite. Readers are always free and unlimited.
See Invite your team and Private documents.
Addon
An addon is an optional feature you turn on for your organization, such as PDF Export, Tags or Reader Feedback. Addons keep the editor simple: you only see the features you use. An Owner or Admin installs them from Addons in the left menu. Most addons are free; some need a particular plan. See Addons.