WordPress Plugin

Add ChatReact AI chatbots, contact forms, and FAQ accordions to your WordPress site with our official plugin.

Download

The plugin is available in the official WordPress Plugin Directory, or as a direct download:

Download ChatReact Plugin v1.2.0

Installation

Method 1: WordPress Plugin Directory (Recommended)

1. Go to Plugins → Add New in your WordPress admin
2. Search for ChatReact
3. Click Install Now, then Activate

Method 2: Upload via WordPress Admin

1. Download the plugin ZIP file above
2. Go to Plugins → Add New → Upload Plugin
3. Choose the ZIP file and click Install Now
4. Click Activate Plugin

Method 3: Manual Upload via FTP

1. Extract the ZIP file
2. Upload the chatreact folder to /wp-content/plugins/
3. Go to Plugins in WordPress admin
4. Find "ChatReact" and click Activate

Configuration

After activation, open the ChatReact menu in your WordPress admin sidebar for settings and usage instructions.

Finding Your Chatbot ID

1. Log in to chatreact.ai
2. Go to your chatbot's Dashboard
3. Click the Copy button next to the Chatbot ID (shown at the top)

Finding Your Form ID

1. Log in to chatreact.ai
2. Go to Forms
3. Click Copy embed code on your form (or open the form and switch to the Embed tab)
4. Your Form ID is the value of data-form-id in the copied embed code

Usage Options

The plugin offers multiple ways to add ChatReact to your site:

1. Shortcodes

Add to any page, post, or widget area:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Optional attributes: language

Contact Form:

[chatreact_form id="YOUR_FORM_ID"]

Optional attributes: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Optional attributes: categories, container, language

2. Gutenberg Blocks

In the block editor:

1. Click + to add a block
2. Search for "ChatReact"
3. Choose ChatReact Chat, ChatReact Form, or ChatReact FAQ
4. Enter your ID in the block settings

3. Elementor

If you use Elementor:

1. Edit your page with Elementor
2. Search for "ChatReact" in widgets
3. Drag the widget to your page
4. Configure in the left panel

4. Widget Assignments (Plugin Settings)

Show a chatbot on specific pages — or your whole site — without editing any content:

1. Open the ChatReact menu in your admin sidebar
2. On the Chat Widget tab, find Widget Assignments
3. Click Add Assignment, choose a page or post (or select Everywhere), and enter your Chatbot ID
4. Click Save Changes

For Everywhere assignments you can exclude specific URLs — one per line, with wildcard support (e.g. /blog/* or /checkout) — to hide the widget on landing pages or during checkout.

By default only Pages are searchable when assigning. Click the Post Types button to make other content types (e.g. Posts or custom post types) searchable too.

5. Page-Level Assignment

Assign a chatbot to a single page directly from the editor:

1. Edit any page or post
2. Find the "ChatReact Widget" meta box
3. Check Enable custom widget for this page
4. Enter your Chatbot ID and optionally choose a position (Default, Bottom Right, Bottom Left)
5. Save the page

The same meta box also offers a Disable all widgets on this page option if you want to hide ChatReact entirely on certain pages.

Shortcode Examples

Basic Chat Widget

[chatreact id="abc123"]

Chat Widget with a Fixed Language

[chatreact id="abc123" language="de"]

FAQ with Category Filter

[chatreact_faq id="abc123" categories="shipping,returns"]

Styled Contact Form

[chatreact_form id="form123" language="en"]

FAQ Widget: SEO & Caching

SEO-Friendly FAQs

Since version 1.1.2, FAQ widgets are rendered server-side: your FAQs are part of the page HTML and include JSON-LD structured data (FAQPage schema). Search engines and AI assistants can read them without running any JavaScript.

llms.txt for AI Crawlers

The plugin can serve your FAQ content at yoursite.com/llms.txt, a discovery file read by AI crawlers. It is enabled by default. To toggle it or set a specific Chatbot ID for the file, go to ChatReact → FAQ Widget → Cache & SEO Settings.

FAQ Caching

FAQ data is cached on your server for fast page loads. Under ChatReact → FAQ Widget → Cache & SEO Settings you can:

• Set the Cache Duration — 1, 3, 6 (recommended), 12, or 24 hours, or disable caching
• Click Clear Cache to refresh your FAQs immediately

The cache is also purged automatically whenever your FAQs change in the ChatReact dashboard.

Supported Languages

The plugin supports 24 EU languages:

• Bulgarian, Croatian, Czech, Danish, Dutch, English
• Estonian, Finnish, French, German, Greek, Hungarian
• Irish, Italian, Latvian, Lithuanian, Maltese, Polish
• Portuguese, Romanian, Slovak, Slovenian, Spanish, Swedish

Since version 1.2.0, translations for all 24 languages are bundled with the plugin. The widget language is detected automatically from the current page, so multilingual sites work out of the box — use the language shortcode attribute only if you want to force a specific language.

Troubleshooting

Widget Not Appearing

1. Verify your Chatbot ID is correct
2. Check if the chatbot is active in your ChatReact dashboard
3. Clear any page caching plugins (see below)
4. Check browser console for JavaScript errors

Caching Plugin Compatibility

The plugin is fully compatible with popular caching and optimization plugins including WP Rocket, LiteSpeed Cache, Autoptimize, and WP Super Cache. The plugin automatically prevents these tools from minifying or caching ChatReact scripts.

If you still experience issues (e.g., 404 errors, widget not loading for logged-out visitors):

1. Clear your caching plugin's cache
2. Exclude chatreact from JS minification/combination in your caching plugin settings
3. The plugin uses data-api-url attributes as a fallback to ensure correct API communication

FAQs Not Updating

If your site shows outdated FAQs, go to ChatReact → FAQ Widget and click Clear Cache. The cache also clears automatically when you edit your FAQs in the ChatReact dashboard.

Styling Conflicts

If the widget looks broken:

• The widget uses isolated CSS
• Check for CSS !important rules in your theme
• Try disabling other chat plugins temporarily

Multiple Widgets

You can use different chatbots on different pages by specifying unique IDs in each shortcode or block.

CMS Integration (Smart Sitemap)

Starting with version 1.1.0, the ChatReact WordPress plugin includes a Smart Sitemap feature that provides the ChatReact crawler with structured content metadata directly from your WordPress site.

How It Works

1. Generate an Integration Key on the ChatReact dashboard (Knowledge Base → Websites → CMS Integrations)
2. Paste the key in the WordPress plugin settings under the Integration tab
3. Select content types you want to share (Pages, Posts, Custom Post Types)
4. Set priorities (High/Medium/Low) per content type
5. When you crawl your website, ChatReact will automatically use the smart sitemap instead of regular link-based discovery

Benefits

• Faster crawling – Direct URL list instead of link-by-link discovery
• Content type awareness – The crawler knows whether a URL is a Page, Post, or Custom Post Type
• Priority-based indexing – Important content (like Pages) can be weighted higher than blog posts
• Selective sharing – Only share the content types you want
• Per-post exclusion – Exclude individual posts/pages from the sitemap via the meta box

Priority Levels

Security

The smart sitemap endpoint (/wp-json/chatreact/v1/sitemap) is protected by the Integration Key. It is not visible to search engines or other crawlers — only ChatReact can access it with the correct key.

Excluding Individual Posts

In the WordPress editor, each post/page has a ChatReact Widget meta box with an option to "Exclude from ChatReact Sitemap". Checked posts will not appear in the smart sitemap.

Requirements

• WordPress 5.8 or higher
• PHP 7.4 or higher
• A ChatReact account (sign up free)

Changelog

1.2.0

• NEW: Bundled translations for all 24 official EU languages

1.1.3

• FIX: Single-category FAQ widgets no longer show an unnecessary "All" filter button and category badges

1.1.2

• NEW: Server-side rendering for FAQ widgets — FAQs are visible to search engines and LLMs without JavaScript
• NEW: JSON-LD structured data (FAQPage schema) for improved SEO and rich results
• NEW: llms.txt endpoint for AI crawler discoverability
• NEW: Automatic FAQ cache purge when content changes in the ChatReact dashboard

1.1.1

• FIX: Translation improvements (Romanian, Dutch)

1.1.0

• NEW: Smart Sitemap (CMS Integration) — structured content sharing with ChatReact crawler
• NEW: Integration tab in plugin settings
• NEW: Content type selection with priority levels
• NEW: Per-post exclusion from sitemap via meta box
• NEW: Protected REST API endpoint for smart sitemap
• FIX: Full compatibility with caching plugins (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
• FIX: Widget loading issues for logged-out visitors with caching plugins

1.0.24

• Widget Assignments — assign chatbots to pages directly from plugin settings
• Gutenberg blocks support
• Elementor integration
• 24 language translations
• Page-level widget assignment
• CHANGED: Widget settings are now managed centrally in the ChatReact dashboard — removed the position, primary_color, and auto_open shortcode attributes (language is still supported)

Next Steps

• Widget Customization →
• FAQ Management →
• Form Configuration →