Skip to content
AskVault Docs
Try Free →

The FAQ Builder

Written by Joseph Russo, Principal Architect, Networks and Tech, AskVault · Reviewed by Allison Chan
Last updated: · 3 min read

Why a public FAQ matters

Three reasons most teams ship one:

  1. SEO. FAQ pages rank for question-style queries, and the schema.org markup tells search engines which text is a question and which is its answer.
  2. Self-service. Visitors who prefer reading over chatting find answers without opening the widget.
  3. Trust signal. A populated FAQ tells visitors you've thought about the common questions.

Where the questions come from

The FAQ page shows your workspace's Q&A pairs: every pair that has finished indexing, oldest first. It is the same list your agent already answers from, so there is nothing to keep in sync. Edit or delete a pair and the published page changes with it (the page can take up to five minutes to refresh).

There are two ways to fill it:

  • Generate. In the FAQ Builder, on the Generate & Edit step, pick how many pairs to draft (5 to 30) and click Generate. AskVault reads your indexed content and writes the questions customers are likely to ask, with answers. Generated pairs are added and indexed straight away, so read through them and edit or delete any that miss the mark. Generation uses your plan's analysis allowance, not your chat message credits.
  • Write them yourself. Add pairs by hand under Knowledge > Q&A Pairs. They appear on the FAQ page too.

Building and publishing the page

Open FAQ in the dashboard. The builder walks you through three steps.

  1. Configure. Choose a URL slug (lowercase letters, numbers and dashes), a title, an optional description and an optional link back to your website. Then set the branding: primary colour, background colour and font. You can also set an SEO title and SEO description, and turn the search box on or off. Your website link and logo address must start with http:// or https://. Colours must be a hex (#4f46e5), named, rgb() or hsl() colour, and the font a plain font list such as Georgia, serif. Other values are refused on save and left off the published page. (This check is rolling out and may not be active on your workspace yet.)
  2. Generate & Edit. Generate pairs, then expand any pair to edit its question and answer, or delete it.
  3. Preview & Publish. Check the preview, then click Publish FAQ Page. The builder shows the public address and a copy button. Unpublish takes the page down again.

The page goes live when you publish. When search engines index it is up to them.

Each workspace has one FAQ page. There is no custom-domain option for FAQ pages.

What the page looks like

  • Header with your logo, title and description, and a "Back to website" link if you set one.
  • Search box (if turned on). It filters the list as the visitor types, matching the question text.
  • Questions as a single list. Each one expands to show its answer.
  • Footer with a "Powered by AskVault" link.

The page is mobile-responsive. Answers are shown as plain text, so Markdown formatting appears as typed.

Embedding on your site

The Preview & Publish step has an Embed Code box with an <iframe> snippet for the published page. Paste it into any page on your site to show the whole FAQ there. There is no way to embed a single question or a filtered subset.

SEO-friendly schema markup

Every published FAQ page carries FAQPage schema.org JSON-LD built from the pairs on the page:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is your refund policy?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "We offer a 14-day refund window..."
      }
    }
  ]
}

Search engines may use it to show your questions in results. The markup is always included; there is no setting to turn it off.

Plan availability

The FAQ Builder is available on every plan, including Free, and there is no cap on the number of entries beyond the Q&A pairs you create. Generating pairs uses your plan's analysis allowance.

Not available today

So you don't go looking for them, these are not part of the FAQ Builder:

  • Categories or sections on the page.
  • Suggestions drawn from visitor conversations, or importing pairs from another source.
  • Per-question analytics or search statistics.
  • An API key (/v1) endpoint for managing FAQ entries.
  • Export to CSV or JSON.
  • More than one FAQ page per workspace, multi-language pages, or a custom domain.

Common pitfalls

FAQ entries don't appear in Google. The page hasn't been crawled yet. Submit the page address in Google Search Console.

A question is missing from the page. Only pairs that finished indexing are shown. Check the pair under Knowledge > Q&A Pairs, and give the page a few minutes to refresh.

Internal content answered from an FAQ entry. FAQ entries have no Audience setting: they are always treated as public, and there is no "Audience Routing" workspace setting. Move anything that must stay off public channels into a document or snippet source and set that source's Audience to internal.

The slug is already taken. Slugs are unique across AskVault. Pick another one.

FAQ

Does the FAQ page count against my message credits?

No. Visitors reading the page don't use message credits. Generating pairs uses your plan's analysis allowance instead.

Will the bot reference FAQ entries when answering chat questions?

Yes. FAQ entries are your Q&A pairs, which are part of the same knowledge index. The bot retrieves them like any other source.

Can I hide the page without deleting it?

Yes. Click Unpublish on the Preview & Publish step. The address stops working until you publish again.

Was this page helpful?