WordPress
Add the agent to a WordPress site with the official plugin and your Organization ID, no theme code.
WordPress is the one platform where you do not paste a script tag. Install the official PepoChat plugin, give it your Organization ID, and the plugin adds the widget to every page and keeps its settings inside your WordPress admin.
What you can do
Put the agent in front of every visitor to your WordPress site with no theme code to edit, choose the corner, keep it off certain paths or for logged-in users, and pair it with the WooCommerce integration for live order status.
Before you start
- A PepoChat account with a workspace. If you do not have one, create one for free and add your website or documents as the knowledge base.
- A WordPress site where you can install plugins, and access to its admin dashboard.
Install the plugin
Get the plugin
Until the WordPress.org listing is approved, download the plugin zip from the WordPress page. Once listed, you can instead search for PepoChat under Plugins → Add New Plugin and click Install Now.
Upload and activate
In your WordPress admin go to Plugins → Add New Plugin → Upload Plugin, choose
pepochat.zip, click Install Now, then Activate Plugin. Activation takes you straight to the plugin's settings page.Copy your Organization ID
In the PepoChat dashboard open Widget Setup and copy the Organization ID. Pasting the whole install snippet also works: the plugin picks the ID out of it.
Paste it under Settings → PepoChat
Paste the ID into Organization ID, choose Widget position, and click Save changes. The status line at the top turns to Connected. The chat widget is live on your site.
Visit your site
The launcher sits in the corner you chose. Colors, greeting and suggested questions come from Widget Customization in the dashboard, so a change there is live on WordPress immediately.
Plugin settings
| Setting | What it does |
|---|---|
| Organization ID | Connects the widget to your workspace. Required. |
| Widget position | Bottom right or bottom left. |
| Preload the chat in the background | On by default. The chat loads during idle time after your page has finished, so the first open is instant. Turn it off to load it only when a visitor clicks the launcher. |
| Hide the widget for logged-in users | Keeps the widget away from editors and members while visitors still see it. |
| Hide on these pages | One path per line, with * as a wildcard. /checkout hides the widget on the checkout page; /my-account/* hides it on every account page. Leave empty to show it everywhere. |
Saving the settings also clears the common page caches (LiteSpeed, WP Rocket, W3 Total Cache, WP Super Cache, WP Fastest Cache, SiteGround, WP Engine and Breeze), so visitors see the change right away.
Updating the plugin
Once the plugin is listed on WordPress.org, updates arrive through the normal Plugins screen. Before that, upload a newer zip the same way you installed it: WordPress shows a comparison and a Replace current with uploaded button. Your settings are kept.
For developers
Two filters are available for themes and site-specific plugins:
// Decide per request whether the widget prints (default: the plugin's own rules).
add_filter( 'pepochat_should_render', function ( $render, $settings ) {
return $render && ! is_page( 'internal-tools' );
}, 10, 2 );
// Point a staging site at a different widget build.
add_filter( 'pepochat_widget_script_url', fn () => 'https://widget.pepochat.com/widget.js' );
Deleting the plugin from the Plugins screen removes its settings from the database.
Troubleshooting
- I see the widget while logged in, visitors do not. Your host or a plugin is serving cached pages. Saving the PepoChat settings purges the caches listed above. If yours is different, or you use a CDN, purge it once.
- "This website is not allowed to use this chat widget." Your workspace's allowed domains do not include this site. Add the domain in Widget Customization and save.
- "That does not look like a PepoChat Organization ID." The value pasted is not a 16 to 64 character ID. Copy it again from Widget Setup.
Next steps
Something missing or wrong on this page? Tell us and we will fix it.