WordPress
Embed your ioZen intake bot on a WordPress site using the theme editor, page builders, or a shortcode plugin.
Add your ioZen intake bot to WordPress in under 5 minutes. Works with the block editor (Gutenberg), classic editor, and popular page builders like Elementor and Divi.
Recommended Embed Type
Widget for site-wide availability. Inline if you want the bot on a specific page or to replace an existing contact form.
Option 1: Widget (Site-Wide)
Add the widget script to your entire site via the theme's header/footer:
- Go to Appearance → Theme File Editor (or Appearance → Customize → Additional CSS/Scripts on newer themes)
- Open
footer.php(or use a plugin like Insert Headers and Footers) - Paste before
</body>:
<!-- ioZen Floating Widget -->
<script
src="https://app.iozen.ai/widget/v2/loader.js?bot=YOUR_BOT_SLUG"
data-bot="YOUR_BOT_SLUG"
async
></script>- Save and verify on your live site
Option 2: Inline (Specific Page)
- Edit the page where you want the bot
- Add a Custom HTML block (block editor) or switch to Text mode (classic editor)
- Paste:
<!-- ioZen Inline Embed -->
<div
data-iozen-inline="YOUR_BOT_SLUG"
style="width: 100%; height: 100%; min-height: 600px; display: flex; flex-direction: column;"
></div>
<script
src="https://app.iozen.ai/widget/v2/loader.js?bot=YOUR_BOT_SLUG"
data-bot="YOUR_BOT_SLUG"
data-type="inline"
async
></script>- Publish or update the page
With Elementor
- Drag an HTML widget to your page
- Paste the inline embed code above
- Save and preview
With Divi
- Add a Code module
- Paste the inline embed code
- Save and preview
Option 3: Popup (Button Trigger)
- Add a Custom HTML block with the script and a trigger button:
<!-- ioZen Popup Modal -->
<button data-iozen-popup="YOUR_BOT_SLUG">
Chat with us
</button>
<script
src="https://app.iozen.ai/widget/v2/loader.js?bot=YOUR_BOT_SLUG"
data-bot="YOUR_BOT_SLUG"
data-type="popup"
async
></script>- Style the button with your theme's CSS, for example by adding
class="wp-block-button__link"to it
Troubleshooting
| Issue | Solution |
|---|---|
| Script stripped from page | WordPress sanitizes HTML in some contexts. Use a Custom HTML block (not a Paragraph block) or a header/footer plugin |
| Bot doesn't load on cached pages | Clear your caching plugin (WP Super Cache, W3 Total Cache, etc.) after adding the script |
| Conflicts with other plugins | Check the browser console for JavaScript errors. The ioZen embed script is self-contained and shouldn't conflict |
Need help? Email us at hello@iozen.ai.