Knowledge Bases

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:

  1. 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
  2. splits the text into chunks of up to 1,000 characters
  3. sends each chunk to OpenAI's embedding model (text-embedding-3-small), which returns a list of numbers that represents its meaning
  4. 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

  1. If the question is in a different language from your site, Promptor translates it into your site's language for the search.
  2. It turns the question into numbers the same way.
  3. It compares those numbers with your chunks and picks the closest matches in meaning.
  4. It sends the best chunks to the AI with your persona, tone and rules.
  5. 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:

RoleShown in the chat as
ServiceA service card the visitor can select to request a quote
ProductA product card with image, price and Add to Cart (Pro, WooCommerce)
FAQA related FAQ link
Blog PostA 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

FreePro
Knowledge bases1 (Default)Unlimited
Content itemsUp to 35Unlimited
Pages, posts and custom post typesYesYes
Q&A entriesYes (count toward the 35)Yes
TXT and Markdown filesYes (count toward the 35)Yes
Word (DOCX) filesNoYes
WooCommerce productsNoYes
Re-index on publish or updateYesYes
Add newly published content automatically (Auto-Add on Publish)NoYes
Website crawler, by hand or on a scheduleNoYes

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.

Still need help?

Our support team answers every ticket. Tell us your WordPress version, Promptor version and what you see.

Read the FAQSee what changed in each version

Open a support ticket

All help topics