The HelpJet WordPress Plugin

The WordPress plugin is the no-code way to put your bot on a WordPress site. You download a zip that already contains your Bot ID, upload it through the WordPress admin, and you're live — the chat bubble site-wide, plus a shortcode and a Gutenberg block for inline chat on specific pages.

Downloading the plugin

1. In your HelpJet dashboard, open your bot and go to the Deploy tab.
2. Switch to the WordPress sub-tab.
3. Click Download Plugin. HelpJet builds a zip on the spot (you'll briefly see "Generating plugin…").

The file is named helpjet-wpdeploy-v1-{yourBotId}.zip. It's pre-configured: your Bot ID is baked into the plugin's folder name, and the plugin reads it from there automatically on activation. There's nothing to copy-paste.

Installing

1. Log in to your WordPress admin dashboard.
2. Go to Plugins → Add New.
3. Click Upload Plugin at the top of the page.
4. Choose the downloaded zip file and click Install Now.
5. After installation, click Activate Plugin.
6. Go to Settings → HelpJet to configure the plugin.

On activation, the plugin detects your Bot ID from its folder name and enables the widget by default — in most cases the chat bubble appears on your site immediately.

Plugin settings

Under Settings → HelpJet you'll find three settings:

Click Save Settings after making changes.

The shortcode: inline chat on any page

To embed the chat directly into a post or page (the equivalent of HelpJet's Page Embed channel), use the plugin's shortcode. Your pre-configured plugin registers a shortcode that includes your Bot ID — the Settings → HelpJet page shows the exact shortcode to copy, which looks like:

• [helpjet-yourBotId] - basic usage. Renders the chat panel at the default height of 600px.
• [helpjet-yourBotId height="800px"] - with a custom height. Any CSS height value works.

Paste the shortcode wherever you want the chat to appear — a dedicated support page, a docs sidebar, a contact page. You can use it alongside the widget: bubble site-wide, inline panel on your /support page.

If the shortcode outputs "HelpJet: Bot ID not configured," open Settings → HelpJet and fill in the Bot ID field.

The Gutenberg block

Prefer the block editor? The plugin registers a HelpJet Chatbot block:

1. Edit a page or post in the block editor.
2. Open the block inserter and search for "HelpJet".
3. Add the HelpJet Chatbot block where you want the chat.
4. Set the height in the block settings if you want something other than 600px.

The block renders the same inline chat as the shortcode — use whichever fits your workflow.

Running multiple bots

Each plugin instance is fully isolated — its own folder, its own settings entry, its own shortcode and block — so you can install more than one:

• Different bots on different WordPress sites: download each bot's plugin and install it on its site. Nothing else to configure.
• Multiple bots on one site: install each bot's plugin zip separately. Each adds its own Settings → HelpJet entry (the settings page title includes the first characters of the bot ID so you can tell them apart), its own [helpjet-botId] shortcode, and its own block in the inserter.

Two cautions when running multiple plugins on one site:

• Only check Enable Widget for one of them. If several plugins have the widget enabled, visitors see multiple chat bubbles stacked in the corner.
• Always use the bot-specific shortcode shown on each plugin's settings page, so there's no ambiguity about which bot renders.

On WordPress multisite, install and activate the plugin per site rather than network-activating, so each site keeps its own bot and settings.

Updating the plugin

The plugin doesn't auto-update through the WordPress plugin directory — you update it by reinstalling:

1. Download a fresh zip from the Deploy → WordPress tab.
2. In WordPress, go to Plugins, deactivate the HelpJet plugin, and delete it.
3. Upload and activate the new zip.

Your settings are stored in WordPress options and survive the reinstall — you won't need to reconfigure anything. Content using the shortcode or block keeps working, since the new plugin registers the same shortcode name.

Troubleshooting

The chat bubble doesn't appear

Work through these in order:

1. Enable Widget is checked under Settings → HelpJet, and the Bot ID field isn't empty.
2. The Bot Widget channel is enabled on your bot's Deploy tab in HelpJet.
3. The bot's Status is Active (HelpJet → Settings → General Settings).
4. Your caching plugin is serving a stale page — purge the cache (and any CDN) after activating, then test in an incognito window.
5. Check the browser console (F12 → Console) for errors mentioning "HelpJet" — see the deployment troubleshooting guide for what each error means.

The shortcode shows an error or nothing at all

• "HelpJet: Bot ID not configured" — set the Bot ID under Settings → HelpJet.
• Nothing renders — enable the Page Embed channel on your bot's Deploy tab and save.
• "Failed to load chat. Please try again later." — the chat couldn't reach HelpJet's servers. Usually temporary; if it persists, check for security plugins or firewalls blocking outbound scripts, and contact support with your bot ID.

Two chat bubbles appear

Two plugins (or the plugin plus a pasted embed code) both have the widget enabled. Keep one: either uncheck Enable Widget in one plugin's settings, or remove the manual embed code from your theme.

Widget appears but uses the wrong color or message

Appearance comes from your HelpJet dashboard, not WordPress. Edit it under Deploy → Bot Widget → Customization and click Save Settings — see Customizing the Chat Widget.

Where to go next

• Using HelpJet with WordPress — training your bot on your WordPress content.
• Embedding & Sharing Your Bot — the other deploy channels.
• Widget Display Rules — show or hide the bubble on specific pages.