WordPress Installation
Install Kentroi on your WordPress site using our official plugin or embed code.
Prerequisites
- A Kentroi account with at least one appointment type configured
- WordPress 5.0 or higher
- Administrator access to your WordPress site
Method 1: Official WordPress Plugin (Recommended)
Our WordPress plugin makes installation easy with a simple shortcode.
Download the Plugin
Download our official WordPress plugin from your Kentroi dashboard.
Upload to WordPress
In your WordPress admin, go to Plugins > Add New > Upload Plugin. Select the downloaded ZIP file and click "Install Now".
Activate the Plugin
After installation, click "Activate Plugin" to enable it.
Configure Settings
Go to Settings > Kentroi Booking and enter your Widget ID. You can find this in your Kentroi dashboard under Embed Widget.
Add the Shortcode
Use the shortcode in any page or post where you want the booking widget to appear.
[kentroi_booking]
<!-- Or for a specific appointment type -->
[kentroi_booking type="appointment_type_id"]Tip
Method 2: Direct Embed Code
If you prefer not to use a plugin, you can embed the widget directly using our JavaScript SDK. The widget renders natively on your page — no iframe needed.
Get Your Embed Code
Log in to your Kentroi dashboard and go to Embed Widget. Copy the embed snippet.
Add a Custom HTML Block
Edit the page where you want the widget. Add a "Custom HTML" block in the WordPress editor.
Paste the Embed Code
Paste your embed snippet into the Custom HTML block.
<!-- Kentroi Booking Widget -->
<div data-kentroi-type="booking" data-widget-id="YOUR_WIDGET_ID"></div>
<script src="https://www.kentroi.com/embed.js" async></script>Save and Preview
Save your changes and preview the page. The widget auto-sizes to fit its content.
Customization Options
Specific Appointment Type
Link directly to a specific appointment type by adding the data-appointment-type attribute:
<div data-kentroi-type="booking" data-widget-id="YOUR_WIDGET_ID" data-appointment-type="APPOINTMENT_TYPE_ID"></div>
<script src="https://www.kentroi.com/embed.js" async></script>Contact Forms
Embed a contact form by using data-kentroi-type="form" with your Form ID:
<div data-kentroi-type="form" data-form-id="YOUR_FORM_ID"></div>
<script src="https://www.kentroi.com/embed.js" async></script>Floating Chat Button
Add the floating chat button to your site's footer template so it appears on every page:
<script src="https://www.kentroi.com/widget.js" data-widget-id="YOUR_WIDGET_ID" data-api-base="https://www.kentroi.com" async></script>Troubleshooting
Widget not appearing
Make sure your Widget ID is correct and your account is active. Check the browser console for errors. Some security plugins may block external scripts — add kentroi.com to your allowed domains if needed.
Script stripped by WordPress
WordPress may strip script tags in some editors. Make sure you're using a "Custom HTML" block, not a paragraph or text block. Alternatively, use the official plugin method above.
Calendar shows wrong timezone
The widget automatically detects the visitor's timezone. Make sure your availability settings in Kentroi are configured with the correct timezone for your business.