Skip to main content

Add LenoChat Plugin to Your WordPress Site

April 15, 2026

Install the LenoChat plugin on any WordPress site in minutes — no theme editing or embed code required.

Why Use the WordPress Plugin?

WordPress powers over 40% of all websites on the internet, and the LenoChat plugin is built specifically to make installation seamless on this platform. Instead of manually placing a JavaScript snippet in your theme's header.php file — which requires code access and breaks on theme updates — the plugin handles the embed code injection automatically on every page of your site. There are several advantages to using the dedicated plugin over a manual code embed:

  • No code editing required — the plugin injects the chat widget script automatically on every page of your site, including custom post types, WooCommerce product pages, and landing pages.
  • Survives theme updates — the widget embed code is stored in the plugin layer, not in your theme files, so it persists even when you change or update your WordPress theme.
  • Widget visibility control — toggle the chat widget on or off globally from the plugin settings panel, or configure availability from your LenoChat dashboard without touching WordPress.
  • Secure authentication — the plugin connects to your LenoChat account using your email and password rather than requiring you to manually copy and paste API keys or license codes.
  • Automatic updates — once installed from the WordPress Plugin Directory, the plugin receives updates automatically alongside your other WordPress plugins whenever new versions are released.

Requirements Before You Begin

Before installing the LenoChat plugin, make sure the following requirements are met. Attempting to install on an incompatible environment may result in the plugin not appearing in your WordPress admin panel or the chat widget not loading correctly on your site.

  • WordPress version 5.0 or higher — the plugin uses modern WordPress APIs and is not supported on older versions. Check your WordPress version by navigating to Dashboard → Updates in the WordPress admin panel.
  • Administrator access — you must be logged in to your WordPress admin account with the Plugins menu visible. Editor-level accounts and below do not have permission to install plugins.
  • An active LenoChat account — you will need your LenoChat email address and password to connect the plugin after installation. If you do not have an account, sign up at lenochat.com before proceeding.
  • An outbound internet connection from your server — the plugin communicates with LenoChat's servers to authenticate your account and load the widget script. Servers with outbound firewalls that block external HTTPS connections may need to whitelist LenoChat's CDN domain.

Step 1: Navigate to the WordPress Plugin Directory

The WordPress Plugin Directory is the official repository of free WordPress plugins, maintained by Automattic. The LenoChat plugin is published here and can be installed with a single click from inside your WordPress admin panel — you do not need to download any files, use FTP, or edit any server configuration.

  • Step 1: Log in to your WordPress admin panel. The URL is typically your-domain.com/wp-admin. Enter your administrator username and password and press Log In.
  • Step 2: In the left-hand navigation sidebar, hover over Plugins to expand the submenu.
  • Step 3: Click Add New (or Add New Plugin in newer WordPress versions) from the submenu. This opens the official WordPress Plugin Directory search interface where you can browse and install plugins directly.
WordPress admin sidebar with Add Plugin option highlighted under Plugins menu

Step 2: Search for and Install the LenoChat Plugin

Once you are on the Add Plugins screen, use the search bar to find LenoChat in the Plugin Directory. WordPress searches the plugin repository in real time and shows matching results with ratings, active installation counts, and compatibility information. Always confirm you have selected the official LenoChat plugin before clicking Install Now.

  • Step 1: In the search bar in the top-right corner of the Add Plugins page, type LenoChat and press Enter or wait for results to appear automatically.
  • Step 2: Locate the LenoChat plugin card in the search results. The plugin is published by the LenoChat team and displays the LenoChat logo. Confirm the publisher name before proceeding to avoid installing a third-party plugin with a similar name.
  • Step 3: Click the Install Now button on the LenoChat plugin card. WordPress downloads and installs the plugin files directly from the repository. The button text changes to Installing… during this process — wait for it to complete.
  • Step 4: When installation finishes, the button text changes to Activate. Do not navigate away from this page while the installation is in progress, as leaving mid-install can result in incomplete plugin files.
WordPress plugin directory search results showing the LenoChat plugin card with Install Now button

Step 3: Activate the Plugin

Installing a plugin and activating it are two separate steps in WordPress. Installation downloads the plugin files to your server; activation enables it and registers it with WordPress so it can run code on every page load. The chat widget will not appear on your website until the plugin is both installed and activated.

  • Step 1: After installation completes, click the Activate button that replaced the Install Now button on the plugin card. This is the fastest path from installation to activation.
  • Step 2: Alternatively, if you navigated away from the Add Plugins screen, go to Plugins → Installed Plugins, find LenoChat in the list, and click the Activate link that appears below the plugin name and description.
  • Step 3: Once activated, a success notice appears at the top of the Installed Plugins page, and a new LenoChat menu item appears in your WordPress admin sidebar. The plugin is now running on your site, but the chat widget is not yet visible to visitors — you still need to connect your LenoChat account in the next step.
WordPress Installed Plugins page showing the LenoChat plugin active and the Activate button highlighted
Tip: If you manage multiple WordPress sites and want the fastest possible installation, WordPress Multisite network installations can activate the LenoChat plugin network-wide in a single click from the Network Admin → Plugins page. Each site in the network then connects to its own LenoChat account independently.

Step 4: Log In to LenoChat from the Plugin Settings

After activating the plugin, click the new LenoChat menu item in your WordPress admin sidebar to open the plugin settings page. From here, you authenticate the plugin by logging in with your LenoChat account credentials. This connects your WordPress site to your LenoChat workspace and configures the widget embed code automatically — no copy-pasting of script tags required.

  • Step 1: Click LenoChat in the left-hand WordPress admin sidebar. If you do not see it, confirm the plugin is activated — go to Plugins → Installed Plugins and verify LenoChat shows as Active.
  • Step 2: On the LenoChat plugin settings page, enter your LenoChat email address in the Email field. Use the same email you registered with at app.lenochat.com.
  • Step 3: Enter your LenoChat account password in the Password field.
  • Step 4: Click the Log In button. The plugin sends your credentials securely to LenoChat's authentication servers. On success, your workspace is connected and the plugin settings page updates to show your workspace details and the Widget Visibility toggle.
  • Step 5: If you see an error message after clicking Log In, double-check your credentials by signing in at app.lenochat.com directly. If you use single sign-on (SSO) or Google login to access LenoChat, you may need to set a standalone password from your LenoChat profile settings before using the plugin login form.
LenoChat WordPress plugin settings page showing the email and password login form to connect your LenoChat account

Step 5: Enable Widget Visibility

Once you are logged in to the LenoChat plugin, you have direct control over whether the chat widget is displayed on your WordPress site. The Widget Visibility toggle is the primary on/off switch for the entire widget — enabling it makes the chat bubble appear on every page of your site immediately, without any additional configuration.

  • Step 1: On the LenoChat plugin settings page in your WordPress admin, locate the Widget Visibility toggle.
  • Step 2: Toggle Widget Visibility to ON to make the chat widget visible to all visitors on your website. The widget script begins loading on every page immediately — no cache clearing or redeployment is needed.
  • Step 3: To temporarily hide the chat widget across your entire site — for example, during site maintenance, A/B tests, or periods when your team is not staffed — toggle Widget Visibility to OFF. The plugin remains installed and your LenoChat account remains connected; the widget resumes the moment you toggle it back ON.
  • Step 4: All other widget configuration — colours, branding, greeting messages, conversation starters, Leno AI settings, and chat hours — is managed from your LenoChat dashboard at app.lenochat.com. The WordPress plugin handles only installation and visibility; all appearance and behaviour settings live in the dashboard.
LenoChat WordPress plugin settings page with Widget Visibility toggle enabled
Tip: After enabling Widget Visibility, open your WordPress website in an incognito or private browsing window and visit any page — you should see the LenoChat chat bubble appear in the bottom corner of the screen. If it does not appear, purge your WordPress caching plugin cache (WP Rocket, W3 Total Cache, LiteSpeed Cache) and any CDN cache (Cloudflare, Fastly) so visitors receive the updated pages containing the widget script.

What Happens After Installation

Once the plugin is installed, activated, and connected to your LenoChat account, your WordPress site is fully integrated with LenoChat. Understanding what changes on your site and in your dashboard helps you confirm the integration is working correctly and prepares your team to start handling chats.

  • Your WordPress site now loads the LenoChat widget JavaScript on every page — including blog posts, WooCommerce product pages, contact pages, and custom post types. No theme editing or manual embed code placement is required.
  • Visitor conversations initiated through the widget on your WordPress site appear in real time in your LenoChat inbox under the Conversations section at app.lenochat.com.
  • Leno AI, if configured and enabled in your workspace settings, begins handling incoming chat requests automatically. Visitors who start a chat receive an immediate AI response — no human agent needs to be online for conversations to begin.
  • Your LenoChat dashboard's Visitors section begins populating with real-time visitor data — including page URLs, session duration, and geographic location — for every active visitor on your WordPress site.
  • If you have configured Chat Hours in your LenoChat dashboard, the widget automatically switches to the offline state (showing an offline message or offline contact form) outside your defined business hours, regardless of whether the WordPress plugin's Widget Visibility toggle is ON.

Common Issues & Solutions

The LenoChat menu item does not appear in WordPress after activation

If the LenoChat admin menu item does not appear after activating the plugin, try deactivating and reactivating it from Plugins → Installed Plugins. This forces WordPress to re-register the plugin's menu hooks. If the issue persists, check whether a security plugin (such as Wordfence or iThemes Security) is blocking custom admin menu registration — temporarily disabling conflicting plugins will help isolate the cause.

Log In fails with an 'Invalid credentials' error

Verify your credentials by signing in at app.lenochat.com directly in a browser — if login works there, the credentials are correct and the issue is likely a firewall or proxy on your WordPress server blocking outbound HTTPS requests to LenoChat's authentication endpoint. Contact your hosting provider to ensure outbound connections to lenochat.com are permitted. If you sign in via Google or another SSO provider, set a standalone password from your LenoChat profile settings before using the plugin login form.

The chat widget does not appear on the site after enabling Widget Visibility

Purge all caching layers first: clear your WordPress caching plugin (WP Rocket, W3 Total Cache, LiteSpeed Cache), any CDN cache (Cloudflare, Fastly), and your browser cache. Then load your site in an incognito window. If the widget is still absent, open your browser's developer console (F12 → Console) and check for JavaScript errors that may be preventing the widget script from loading. Also confirm that no script-blocking browser extension is active in your test session.

The plugin installs but shows an outdated version number

WordPress serves plugin files from its own content delivery network, which can occasionally lag a few hours behind the latest release. If you need the most recent version immediately, download the plugin zip file directly from the WordPress Plugin Directory website and install it via Plugins → Add New → Upload Plugin. Once installed this way, automatic updates resume normally for all future versions.

Frequently Asked Questions

Can I install LenoChat on multiple WordPress sites with one account?

Yes. You can install the LenoChat plugin on as many WordPress sites as you need and log in with the same LenoChat account on each one. All sites connected to the same workspace share the same chat inbox, widget settings, and Leno AI configuration. If you need separate inboxes or settings per site, create a separate LenoChat workspace for each website.

Do I need to edit my theme files or insert any code manually?

No. The LenoChat WordPress plugin automatically injects the widget embed script across your entire site after you log in and enable Widget Visibility. You do not need to modify functions.php, header.php, or any other theme file. The plugin works with any WordPress theme, including block themes that use Full Site Editing.

Will the chat widget appear on every page of my WordPress site?

Yes. By default, the chat widget loads on every page of your WordPress site once Widget Visibility is enabled, including blog posts, static pages, WooCommerce product and checkout pages, and custom post types. If you need to exclude specific pages from showing the widget, contact LenoChat support for guidance on page-level visibility options.

What happens to the chat widget if I deactivate the LenoChat plugin?

Deactivating the plugin immediately removes the widget from your WordPress site — the embed script is no longer loaded and the chat bubble stops appearing for visitors. Your LenoChat account, conversation history, and dashboard settings remain completely intact. Reactivating the plugin restores the widget without needing to log in or reconfigure anything.

Is the LenoChat WordPress plugin free?

The WordPress plugin itself is free to download and install from the WordPress Plugin Directory. It requires an active LenoChat account, which offers both a free plan and paid plans. The free plan includes basic live chat functionality. Paid plans add Leno AI automation, advanced widget customisation, chat hours management, and additional features. Visit lenochat.com/pricing for a full comparison.

Does the LenoChat plugin work with WooCommerce?

Yes. The LenoChat plugin loads the chat widget on all WordPress pages, including WooCommerce shop listings, product detail pages, the cart, and the checkout page. This allows your team to answer product questions and assist customers in real time during the purchase process, helping reduce cart abandonment and increase conversions.

How do I update the LenoChat WordPress plugin?

Updates are delivered automatically through the standard WordPress update mechanism. When a new version is available, a notification appears in Plugins → Installed Plugins and in the WordPress Dashboard update count badge. Click Update Now to apply the update. No reconnection to your LenoChat account is required after updating — your login session and widget settings are preserved.