Troubleshooting

Frequently asked questions

Quick answers to common Promptor questions about API keys, the monthly allowance, providers, languages, handoff, data, licenses and support.

Short answers to the questions site owners ask most. Each answer links to the full article.

Getting started

Do I need an OpenAI API key?

Not to try Promptor. The free trial lets you test the chat without a key: 25 AI answers from 3 pages. For real use you add your own key from the OpenAI platform, with a payment method added to your OpenAI account (or connect Claude or Gemini through the WordPress AI Client). With your own key, the free edition gives you one knowledge base with up to 35 items and 100 AI answers a month; Pro is unlimited. See Get and add an OpenAI API key.

What happens when the free edition's 100 answers are used up?

The chat shows "Monthly limit reached (100 queries)…" instead of AI answers until the allowance resets automatically after the last day of the month. The lead form keeps working, so visitors can still leave their details. Pro has no monthly allowance; your AI provider bills you for what you use. See Free vs Pro.

How much does the AI cost?

OpenAI charges you directly for usage, typically $0.01–$0.10 per conversation. You can cap usage in Settings › AI Usage. See Control AI costs with usage limits.

Can I use Claude (Anthropic) or Gemini (Google)?

Yes, on WordPress 7.0 or later. Choose WordPress AI Client as the AI Provider in Settings › AI Behavior and add your provider's key in WordPress Settings › Connectors. You still need an OpenAI key, because Promptor uses OpenAI to index your content for search. See Choose your AI provider.

What are the requirements?

WordPress 5.8 or later (tested up to 7.1) and PHP 8.0 or later. WooCommerce is optional. See System requirements.

Using the chat

Why doesn't the AI know about my page?

It probably isn't selected in the knowledge base, or it was selected but never synced. Selected pages are re-indexed automatically when you update them, but a newly selected page needs a Sync. For facts that aren't on any page, add a Q&A entry. See Answers are wrong or miss your content.

Which languages does it speak?

The AI replies in the language the visitor writes in. Promptor's admin screens and the chat widget's buttons and labels come in seven languages: English, Turkish, German, Spanish, French, Italian and Brazilian Portuguese. By default they follow your WordPress language; you can pin one in Settings › UI Settings › Language without changing the rest of WordPress. See Change the plugin language.

Can visitors talk to a real person?

Yes. Turn on human handoff in Settings › Handoff & Channels. When a visitor asks for a person, the chat offers your WhatsApp, email or phone with a pre-filled summary of the conversation. Pro adds Telegram, Messenger, custom links, live-chat launch, operating hours and a low-confidence trigger. See Hand visitors over to a human.

Can I add the chat with the block editor?

Yes. Since 2.1.0 there is a Promptor Chat block in both editions; pick the knowledge base in the block's sidebar. See Add the chat with the Gutenberg block.

Will it work with my theme?

Promptor isolates the chat from your theme's styles and works with standard themes such as Astra, Kadence, GeneratePress, Neve and the default WordPress themes. See The chat doesn't appear or looks wrong.

Does the chat remember earlier messages?

Yes. With Conversation Memory on in Settings › UI Settings (on by default), the AI uses earlier messages as context for its answers. The chat itself is kept in the visitor's browser tab, so the last 15 messages are still there when the visitor reloads or moves to another page with the same chat. The refresh button in the chat header starts a new conversation.

Why do answers appear all at once instead of word by word?

Your host or CDN buffers the response, so Promptor switches to normal answers automatically. Streaming also isn't used during the free trial or with the WordPress AI Client. See Streaming responses.

Can Promptor replace my contact form?

Yes. The chat collects name, email, phone and a message, and saves each lead on the Submissions screen. See Capture leads inside the chat.

Does it work with caching plugins?

Yes, with a few precautions for WP Rocket, LiteSpeed Cache, SiteGround Optimizer and others. See Caching plugins.

Errors

Visitors see "Security verification failed"

A cached page is usually serving an expired security token. Clear the cache and see Caching plugins.

Visitors see "Monthly limit reached (100 queries)"

The free edition has used its 100 AI answers for this month. They reset automatically at the start of the next month, and the lead form keeps working until then. See Free vs Pro.

The chat refuses some questions

Since 2.1.0 the assistant only answers questions about your business. It politely declines general knowledge, code, homework and questions about other companies. See Answers are wrong or miss your content.

Where do I look up other messages?

See Error messages explained.

Data and privacy

What happens to my data if I deactivate Promptor?

Nothing. Deactivating keeps all settings, knowledge bases, leads and conversations.

What happens if I delete Promptor?

Deleting the plugin from the Plugins screen removes its database tables (leads, conversations and indexed content) and its settings. Promptor has no CSV export, so copy any leads you want to keep first, for example with Tools › Export Personal Data for each contact. See Privacy, GDPR and the data Promptor stores.

Is Promptor GDPR-friendly?

Promptor works with the WordPress tools Tools › Export Personal Data and Tools › Erase Personal Data for leads, does not store visitor IP addresses in its tables, and its telemetry is off unless you opt in. See Privacy, GDPR and the data Promptor stores.

Updates and licenses

Will updating Promptor reset my settings?

No. Updates keep your settings, knowledge bases and leads, and the database upgrade runs on its own. See Upgrade, activate your license and update.

My license key doesn't activate

Check that you copied the whole key, that you haven't used up the sites in your plan, and that your server can reach Freemius. Manage your sites at users.freemius.com.

Can I use my license on a staging site?

Usually yes. Common staging and development domains (such as localhost, .local, dev. and staging.) are typically not counted against your site limit.

Where do I find my invoices?

Your receipt email is your invoice. All past invoices are in your Freemius account.

Support

How do I get help?

Include your Promptor, WordPress and PHP versions, the exact error message and your caching plugin. Never send your API key.

Support covers Promptor's features, settings, setup and bugs. It does not cover custom development, third-party plugins or themes, or general WordPress help.

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