AI knowledge engine for very large WordPress sites with hundreds or thousands of pages.
Turns high volume content and blogs into findable answers, with no hallucinations and grounded only in your own content. 100% private, your content is never used to train AI models.
Five-minute set-up. Automatic ingestion. Bring your own Anthropic key (pro version available for other major models, embedding, and for fuzzy search).
Your content already has the answers
You've spent years writing posts, pages, FAQs and policies. Most visitors never read them — they scan for a few seconds, don't spot what they came for, and leave, straight past the answer you already wrote.
GoldenRetriever AI Chat fixes that. When a visitor asks a question, it finds the relevant passages in your own content and answers from those — instantly, in plain language, and it shows which of your pages the answer came from. The answer was already buried in your site; the plugin fetches it. There's no knowledge base to rebuild, nothing to retrain, no copying and pasting your content into a separate tool.
And because every answer is drawn only from your own published content, the advisor stays grounded in what you actually said — it isn't inventing facts or pulling from the open web. That retrieve-then-answer method is the same principle behind today's most reliable AI assistants: find the right source first, then answer from it.
Built for non-technical site owners. Five-minute setup from "install" to "ask my first question." Native WordPress UI, Gutenberg block, classic shortcode, sensible defaults for every option, and a built-in Test Chat panel so you can sanity-check the advisor before any visitor sees it.
Features in this free release
- Streaming Claude chat — Server-Sent Events flow tokens to the visitor as Claude generates them.
- Encrypted BYO API key — Your Anthropic key is encrypted with AES-256-GCM at rest, tied to your WordPress salts. Only the last four characters are ever shown in the UI; the plaintext is never echoed back.
- Three placements — site-wide floating bubble, Gutenberg
GoldenRetriever AI Chat block, or [grchat_chat] shortcode; inherits your theme's colours and fonts automatically.
- Theme-inheriting widget — picks up
--wp--preset--color--primary and your body font where the theme exposes them; falls back to a neutral palette.
- Site-grounded answers from your own content — posts and pages (including shortcode and page-builder output) are rendered and indexed, so the advisor retrieves the relevant passages from your site before it answers.
- Incremental updates on save — the index updates automatically when you publish or update a post; no manual re-index needed for routine changes.
- Resumable "Reindex all content" job — a one-click full reindex with a live progress bar; safe to stop and restart at any time.
- URL and file knowledge sources — administrators can add a public URL (SSRF-guarded via
wp_safe_remote_get()) or upload .txt / .md files to extend the knowledge base.
- Configurable maximum response length — cap token usage per reply to control cost.
- Signed-token + rate-limited public chat endpoint — the anonymous front-end chat endpoint is protected by a short-lived signed request token; per-IP and global rate limits (both filterable) stop abusive traffic.
- Advanced prompt editing with reset — edit the system prompt in the admin, inject important links (booking URL, contact page, support email) automatically into every conversation, and reset to the shipped default with one click.
- Important links injection — the advisor automatically weaves your booking URL, contact page, and support email address into answers; no manual prompt editing required.
- Email me this chat — visitors can email themselves the conversation transcript from inside the widget. Consent-aware: the visitor's email is stored in your site's own database only when they opt in (not sent to any external service). Administrators can view captured leads in wp-admin, export them as a CSV from the Leads tab, and the table is fully covered by WordPress's built-in privacy exporter and personal-data eraser tools.
- Leads tab — paginated list of visitors who opted in to receive their transcript, with CSV export and injection-safe column handling. Pro routes leads to your inbox or CRM with full conversation context.
- Bug report — the Support tab lets you send a pre-filled diagnostics report to the support team via your own email client (mailto), with recent log entries attached. No data leaves your server until you click Send in your email app.
- Refer a friend — one-click referral link from the Support tab (draft copy shipped; final wording is a pending decision).
- Optional "Get your own" widget link — a small, configurable attribution link in the widget footer that drives word-of-mouth. Toggle it off from the Appearance tab.
- Full uninstall cleanup — removing the plugin drops all plugin-created tables and options; no orphaned data.
How it works in three steps
- Install the plugin and activate it. WordPress redirects you straight to the Settings tab on first run.
- Paste your Anthropic API key, pick a Claude model (Sonnet, Opus or Haiku), and save. The key is encrypted before it hits the database.
- Decide where the chat lives — flip Floating widget on for site-wide, or drop the
[grchat_chat] shortcode / GoldenRetriever AI Chat block on any page.
What's coming in GoldenRetriever AI Chat Pro
The free version is the chat surface. Pro adds OpenAI and Gemini providers, multi-persona advisors, PDF/DOCX/CSV file knowledge with embeddings retrieval, lead routing to your inbox/CRM with full conversation context, and white-labelling — all as a separate plugin you install alongside the free version. No data migration, no breakage.
The complete version history is in changelog.txt. Recent releases:
0.18.10
- Fix: on sites using LiteSpeed Cache with "Remove Unused CSS" turned on, the chat widget no longer appears as unstyled text and buttons. The plugin now tells LiteSpeed to keep the widget's stylesheet; your own LiteSpeed settings are not changed.
0.18.9
- Models: the Claude 5.5 models (Sonnet 5.5, Opus 5.5, Haiku 5.5) are now available, and Claude Sonnet 5.5 is the new recommended default for sites that have not picked a model. Sites that chose a model keep it; the older Claude 4 models stay selectable.
- Models: the model list now also shows any other model your Anthropic key can use, fetched from Anthropic at most twice a day while you are on the Settings tab, so new Claude models appear without waiting for a plugin update.
- Reliability: on Claude 5 models, replies are no longer cut short by the model's internal reasoning, which counts against the response length. The plugin keeps reasoning at a low level for fast chat replies (filterable via
grchat_claude_effort) and reserves room for it on top of your response-length setting.
- Fix: when Anthropic's safety systems decline a question, visitors now see a short "can't help with that" reply instead of an empty answer.
0.18.8
- Compatibility: tested against WordPress 7.1 and marked compatible.
- Compatibility: the chat panel block now declares block API version 3, so it runs natively inside the iframed post editor that WordPress 7.1 always uses. The block already rendered correctly there; this removes a deprecation warning and keeps it working as older non-iframe editor fallbacks are retired.
0.18.7
- Maintenance: updated the WordPress.org listing copy and description. No functional or code changes in this release.
0.18.6
- Security: chat links generated from AI replies are now validated more strictly, closing a way a maliciously crafted link could have run script in a visitor's browser when clicked.
- Security: content indexing now renders your pages exactly as an anonymous visitor sees them, so text that membership or content-restriction plugins hide from the public can no longer end up in chat answers. Re-including a previously excluded post also re-checks that it is still published before it is indexed.
- Reliability: the automatic first-run indexing job can no longer get permanently stuck if it is interrupted mid-run; it now resumes on the next scheduled tick.
- Reliability: brief provider overloads (Anthropic "overloaded" or rate-limit responses) are retried automatically before the visitor sees an error.
- Fix: the widget no longer returns "not allowed" errors for visitors browsing your site on the www variant of your domain (or vice versa).
- Fix: the "Index your content" link shown on a fresh install now opens the settings page instead of a permissions error, and "Exclusion list saved." displays as a success message instead of an error.
- Fix: replies interrupted by a dropped connection are now marked as possibly incomplete instead of looking finished; long replies also render noticeably more smoothly while streaming.
- Fix: knowledge files with uppercase extensions (for example README.TXT) and UTF-16 text files saved by Windows Notepad now upload correctly.
- Privacy/data: a new "keep my data" option on the Advanced tab preserves your settings, index and leads if you delete the plugin, and deleting the free plugin no longer removes data while the Pro plugin is still installed.
- Maintenance: the leads CSV export now opens correctly in Excel with non-ASCII names; the plans page no longer loads a script from an external CDN; many smaller hardening and build-pipeline improvements.
0.18.5
- Fix: knowledge-base file uploads no longer fail with a "You do not have sufficient permissions to upload files" error on sites running CleanTalk Security & Malware Firewall (and similar plugins that screen admin-area uploads). Uploads now use an AJAX endpoint those scanners don't block; settings, sources, and the rest of the Knowledge tab are unchanged.
0.18.4
- Upgrade: a new "Go Pro" tab lets you compare the Personal, Business, and Agency plans — sites and AI personas included — and start checkout on the tier you choose, right inside the dashboard, instead of opening a new tab and always landing on the entry plan.
0.18.3
- Grounding: a fresh install now indexes your existing published content automatically in the background, so answers are grounded without a manual reindex; an admin notice shows index status (building / empty / ready).
- No-hallucination: when nothing relevant is indexed yet, the assistant now says it doesn't have that information instead of guessing from general knowledge.
- Knowledge uploads: clearer, accurate error messages when a file can't be added (no longer implies only .txt/.md are supported, and explains that scanned/image-only PDFs have no extractable text).
- Maintenance: uninstall cleanup now runs via the Freemius after_uninstall hook instead of a bundled uninstall.php (no change to what gets removed).
0.18.2
- i18n: the "provider unavailable" messages shown to administrators are now translatable.
0.18.1
- Chat block: the persona attribute set by the Pro editor add-on now persists reliably across save and reload (declared in the block's editor schema).
- Reliability: if a configured provider becomes unavailable (e.g. a Pro provider after the Pro plugin is deactivated), the widget no longer answers visitors with placeholder text — it uses your Claude provider if configured, otherwise reports the assistant as temporarily unavailable.
- Add-on provider errors now surface a useful diagnostic to admins instead of a generic "unexpected error".
0.18.0
- Improved: the "Upgrade to Pro" links open the Pro checkout showing all plans (leading with the entry price, and offering existing customers a prorated upgrade), instead of the in-admin Add-Ons page that highlighted the top-tier price.
- Improved: your licence and account details now appear as an "Account" tab inside the GoldenRetriever settings screen, instead of a separate WordPress submenu — including the option to change plan (upgrade/downgrade).
- Fix: the "Exclude specific content" search on the Knowledge tab now works on sites using default (plain) permalinks. Previously the search box returned no results there, so items could not be added to the exclusion list.
- Fix: the automatic "Homepage (auto)" knowledge source no longer shows "That URL cannot be fetched" on localhost installs and on hosts that resolve their own domain to a private address — fetching your own site is now routed through the loopback-safe path, matching the background reindex.
0.17.0
- Fix: uploaded-file knowledge sources are no longer cited with a filename dressed up as a URL. The advisor now labels them "(uploaded file)", so it can't tell a visitor to "visit" a non-clickable file path.
0.16.0
- Knowledge tab: new "Exclude specific content" picker — search for any post or page by title, add it to the exclusion list, and the advisor will never surface it. Excluded items survive a full reindex.
- REST endpoint
GET /grchat/v1/admin/search-content?q=… for the title-search picker (admin-only; requires X-WP-Nonce).
0.15.0
- New: a native in-admin upgrade path to GoldenRetriever AI Chat Pro. The free plugin now connects to Freemius as the parent product, so you can browse and buy Pro from your WordPress dashboard. The connection opt-in is entirely optional and skippable — the plugin is fully functional without a Freemius account.
0.14.0
- Knowledge tab: the file-upload form now lists the file types your install can actually ingest, shows per-type caveats, and points to the Pro add-on for PDF/Word/CSV uploads.
- Developer seams for the Pro lead-routing add-on:
grchat_lead_captured (fires when a consented transcript lead is stored) and grchat_leads_after_table (Leads-tab render hook).
0.13.0
- Provider-aware Settings: one unified form with a default-provider selector, the active provider's model list, and provider-aware "configured" checks for the notices, connection test, and Try-it panel.
- New developer hooks:
grchat_settings_provider_fields, grchat_settings_after_save, grchat_provider_models, grchat_provider_configured (consumed by GoldenRetriever AI Chat Pro). Retired grchat_settings_after_provider.
- Anchored the System prompt heading so the Pro Agents link lands on it.
0.12.0
- Admin consolidation: the Settings tab is now the single home for your AI provider key, the system prompt, the connection test, and a "Try it" chat — the Advanced, Connection test, and Test chat tabs have been folded in.
- New
grchat_settings_after_provider action lets companion plugins (GoldenRetriever AI Chat Pro) add provider key fields directly under the Anthropic key.
0.11.0
- Developer: retrieval re-ranking and upload-extraction extension points for the upcoming Pro plugin and third-party developers — a retrieval candidate-pool filter (grchat_retrieval_candidates), a post-retrieval re-rank filter (grchat_retrieved_chunks), and upload filters for accepted file types, extraction, and size (grchat_upload_file_types / grchat_upload_extract_text / grchat_upload_max_bytes). No behaviour changes when nothing is hooked.
0.10.0
- Developer: extension points for the upcoming Pro plugin and third-party developers — a provider registry filter (grchat_llm_providers), per-request agent resolution on the public chat endpoint (grchat_agent_config + optional agent parameter), admin tab registration (grchat_admin_tabs / grchat_admin_tab_render), a per-request model override in provider options, and an agent attribute on the block, shortcode and floating widget (grchat_widget_default_agent) passed through to the chat request. No behaviour changes when nothing is hooked.
Older releases (0.9.6 and earlier) are listed in changelog.txt.