Citewell for software companies: a docs assistant that shows its sources

Put an assistant on your app or docs site that answers from your documentation, cites the exact passages, and opens a ticket when the docs fall short.

Use case · Updated · by the Citewell team

Software companies write a lot of documentation and still answer the same questions in support every week: how to reset two-factor authentication, where an export lives, what a plan includes, why an integration stopped syncing. Citewell turns your existing docs into an assistant that answers in a chat widget, links the exact passages it used, and hands over to your team when the docs don't cover the question.

Why citations matter for software support

Technical answers are only useful if they are right for the reader's version, plan and setup. A citation lets the user check the source in one click, and lets your support team see at a glance why the assistant said what it said. In Citewell every answer shows its sources as numbered links. Written answers are labelled as AI-written, and answers that fail the checks (no citation, a citation to a passage it wasn't given, or a number that isn't in the passages) are never shown.

Getting your docs in

  • Import by URL. Add public pages from your docs site. Citewell fetches each page once, removes navigation, scripts and styles, and keeps the text. Use *Re-fetch* after you update a page. Pages must be public HTML or plain text, under 2 MB.
  • Paste Markdown. For content that isn't public yet, paste it with a title and, if it has one, its public link. Markdown headings are kept with their text, which helps the assistant pick the right passage.

Each article is split into passages of about 160 words. Retrieval is keyword-based (the BM25 method with English word stems), so it matches *refunds*, *refunded* and *refunding* to *refund*. It does not understand meaning beyond the variants and synonyms you give it, which is why naming things consistently in your docs pays off. The help article on adding knowledge covers the limits.

Teach it your product's vocabulary

Users rarely use your internal names. Under Knowledge base → Synonyms, add one group per line:

workspace, team, account
seat, user, member
plan, tier, subscription

A synonym match counts a little less than the exact word, so the article that uses the user's own words still ranks first.

Hand-off that keeps context

When the assistant can't help, the user clicks Talk to a human, leaves an email and a message, and a ticket appears in your inbox with the whole conversation attached. Your reply is emailed to them with a private link to the thread; their answer reopens the ticket. Open tickets that wait more than 24 hours trigger a reminder to the team. See escalations and the team inbox.

Using Analytics as a docs backlog

Questions the assistant couldn't answer are listed under Analytics, together with answer and escalation rates. For a software team this is the most useful part: it is a list of missing or badly titled docs, in your users' own words. A weekly habit that works:

  1. Read last week's unanswered questions.
  2. For each cluster, decide: missing article, article with the wrong words, or a question only a person can answer (billing disputes, bugs).
  3. Fix the first two kinds in your docs and re-fetch.

Where it sits in your product

The widget is one script tag. Paste it in your docs site, your marketing site, or inside your app's layout. You can run up to 10 widgets on Pro, for example one per product or language, and turn any widget off instantly; it then shows "Chat unavailable".

What it is not

Citewell is not an agent that acts in your product. It cannot reset a password, change a plan or read a user's data. It answers from the content you give it and routes everything else to people. That narrow scope is what makes it safe to put in front of customers.

Cost and limits

The Free plan includes 100 answers a month, 5 knowledge sources and included AI for written answers (fair use, 20 a day). Pro is $79 a month excluding VAT, with 5,000 answers, 200 sources and 200 written AI answers a day. Past the daily AI limit, users still get the most relevant passages with links. Add your own Anthropic key if you want AI answers without that daily limit.

Try Citewell free

A help assistant that answers from your own articles, shows its sources, and hands off to your team when it is not sure. The Free plan needs no card; you can export or delete your data any time.