How knowledge bases work
Understand how Promptor turns your pages into a searchable knowledge base, how it picks content for each answer, and what Free and Pro allow.
A knowledge base is the set of content your assistant answers from. You choose the pages, posts, products or files, add your own Q&A entries, Promptor indexes them, and the chat uses them to answer visitors.
Knowing how this works helps you choose the right content and fix answers that miss.
From page to answer
1. You select content
On the knowledge base's content screen you tick items and give each one a Content Role: Service, Product, Blog Post or FAQ. See Choose content and set content roles.
A knowledge base can hold:
- pages, posts and custom post types from your site (one tab each)
- Q&A entries you write yourself on the Q&A tab. See Add Q&A entries.
- files from your Media Library on the Files tab: TXT and Markdown in Free, plus PDF and DOCX in Pro. See Add TXT, Markdown, PDF and DOCX files.
- WooCommerce products (Pro)
- pages found by the website crawler (Pro)
2. Promptor indexes it
When you click Save & Sync or Sync, Promptor:
- reads the main content of each item: the text you write in the WordPress editor (shortcodes in the content are run first, and HTML is removed), the text of a file, or the question and answer of a Q&A entry
- splits the text into chunks of up to 1,000 characters
- sends each chunk to OpenAI's embedding model (
text-embedding-3-small), which returns a list of numbers that represents its meaning - stores the chunks and their numbers in your WordPress database
The card on Knowledge Bases › Manage then shows Indexed Docs / Chunks, for example 26 / 182: 26 items split into 182 chunks.
After that, Promptor keeps the index fresh by itself. When you publish or update a selected item, it is re-indexed. When you unpublish or trash it, it is removed from the index. Q&A entries are indexed the moment you save them.
Indexing always uses your OpenAI API key, even if answers come from another provider through the WordPress AI Client. See Choose your AI provider.
3. A visitor asks a question
- If the question is in a different language from your site, Promptor translates it into your site's language for the search.
- It turns the question into numbers the same way.
- It compares those numbers with your chunks and picks the closest matches in meaning.
- It sends the best chunks to the AI with your persona, tone and rules.
- The AI writes the answer in the visitor's language and may add cards for related content.
Because the search compares meaning, a visitor who asks "How much is a website?" can find your page titled "Web design packages".
If nothing in the knowledge base matches, the question is marked Unanswered under AI Conversations, so you can add the missing answer. See Review unanswered questions.
What content roles do
The role tells Promptor how to present an item when it is relevant:
| Role | Shown in the chat as |
|---|---|
| Service | A service card the visitor can select to request a quote |
| Product | A product card with image, price and Add to Cart (Pro, WooCommerce) |
| FAQ | A related FAQ link |
| Blog Post | A related article link |
All roles are used as source material for the answer text.
One knowledge base or several
Every site has a knowledge base called Default, which the plain [promptor_search] shortcode uses. It cannot be deleted.
With Pro, you can create more knowledge bases for different purposes, for example sales and support, and show each one on its own page:
[promptor_search context="support"]
Each knowledge base has its own content, roles and example questions. You can also give each one its own persona and tone under Settings › AI Behavior › Knowledge Base Overrides. See Persona, tone and per-knowledge-base behavior.
Free and Pro limits
| Free | Pro | |
|---|---|---|
| Knowledge bases | 1 (Default) | Unlimited |
| Content items | Up to 35 | Unlimited |
| Pages, posts and custom post types | Yes | Yes |
| Q&A entries | Yes (count toward the 35) | Yes |
| TXT and Markdown files | Yes (count toward the 35) | Yes |
| Word (DOCX) files | No | Yes |
| WooCommerce products | No | Yes |
| Re-index on publish or update | Yes | Yes |
| Add newly published content automatically (Auto-Add on Publish) | No | Yes |
| Website crawler, by hand or on a schedule | No | Yes |
The free version also answers up to 100 questions a month, resetting every month.
Unlimited content, products, Word (DOCX) files and the crawler are part of Promptor Pro. Compare plans.
During the free trial
The trial in the setup wizard works differently. It does not create a searchable index. Instead it copies the text of up to 3 pages into a temporary trial content store and sends that text to the AI with each question. The knowledge base screen shows "Trial Mode: Using temporary AI context from your selected pages."
To build a real knowledge base with up to 35 items, add your OpenAI API key and sync your content.
Tips for better answers
- Choose pages that answer real visitor questions: services, pricing, FAQs, policies.
- Write a Q&A entry for anything your pages don't spell out, such as opening hours or a refund rule.
- Keep the important text in the page content itself. Text that lives only in theme templates, widgets or sidebars is not indexed.
- Give each page a clear title and a short intro. Promptor uses them to describe the item.
- Check the Unanswered view regularly and fill the gaps it shows. See Sync, re-index and clear a knowledge base for how the index stays up to date.
Related
Still need help?
Our support team answers every ticket. Tell us your WordPress version, Promptor version and what you see.
