How to Add Mindbody Booking to WordPress (3 Ways, 2026)
Branded Web widget, a Mindbody WordPress plugin or a custom integration on the API: step by step, and what each one costs you in design, speed and tracking.
You run your studio on Mindbody and your website on WordPress. Sooner or later the question comes up: how do you get Mindbody booking onto the site? There are three ways to do it, and they are not equal.
The short answer:
- Paste a Mindbody Branded Web widget (formerly Healcode). Free, done in 15 minutes, but booking runs inside a Mindbody iframe with Mindbody’s look.
- Install a Mindbody WordPress plugin such as MZ Mindbody API. Your schedule displays in your theme, but sign-up and payment still hand off to Mindbody.
- Build a custom integration on the Mindbody API, usually packaged as a custom WordPress plugin. Schedule, booking and checkout live in your theme, in your brand, with real tracking. It is a project, not a download.
| Branded Web widget | Mindbody WordPress plugin | Custom integration | |
|---|---|---|---|
| Setup | Copy and paste | Install + API credentials | Development project |
| Look | Mindbody’s | Your theme for the list, Mindbody’s for booking | 100% your brand |
| Where booking happens | Mindbody iframe | Mindbody pages | On your site |
| GA4 / Google Ads purchase tracking | No | No | Yes |
| Pick-a-spot, waitlists, instalments | Mindbody’s options only | No | Yes |
| Running cost | Included in Mindbody | Free plugin, Mindbody API usage | Build + maintenance |
Now the details, method by method.
Method 1: paste a Branded Web widget
This is Mindbody’s official way to put booking on any website. Mindbody calls it Branded Web; it used to be Healcode, and the code still says so.
Step by step:
- In your Mindbody account, open the Branded Web tools and create the widget you need: schedule, appointments, registration, a “Buy now” button for a pricing option, or a login link.
- Pick the colours and fonts in the widget editor, then copy the embed code.
- In WordPress, edit the page, add a Custom HTML block (or the HTML widget of your page builder) and paste the code.
- Publish, then test on a real phone: scroll inside the schedule, book a class, go through payment.
What actually lands on your page. The modern schedule widget is a <healcode-widget data-type="schedules"> tag. When it loads, it injects an iframe pointing to go.mindbodyonline.com. Everything inside that frame belongs to Mindbody. Your theme’s CSS stops at its border, which is why the editor only lets you change colours and fonts, not the layout or the journey.
Common pitfalls on WordPress:
- Optimisation plugins. WP Rocket, Autoptimize and similar tools that delay or combine JavaScript can stop the widget from loading. Exclude the Healcode script from “delay JS” and minification.
- Layout shift. The iframe arrives after the page has rendered and pushes the content down. Reserve a minimum height around the block.
- Mobile scrolling. A tall iframe inside a scrolling page creates a “scroll within a scroll” that frustrates thumbs.
- No purchase data. Payment happens inside Mindbody’s frame, so GA4 and Google Ads do not see the sale.
Choose this if you need booking online today, at zero cost, and you can live with the standard Mindbody look.
Method 2: install a Mindbody WordPress plugin
There is no official Mindbody plugin on WordPress.org any more: the old “MINDBODY Widget” plugin was closed in March 2021. What remains are third-party plugins.
- MZ Mindbody API (free, open source, still maintained in 2026). It reads your schedule, events and staff through the Mindbody API and displays them with shortcodes, using templates you can override in your theme.
- MB Spirit for Mindbody (plugin for a paid service, last updated in 2023). Shortcodes for schedules, events, staff and products built in the MB Spirit dashboard.
Setting up MZ Mindbody API, in short:
- Create a developer account on the Mindbody developer portal and get an API key.
- Ask the studio owner to activate your access to their Mindbody site (you send an activation link for their Site ID; they approve it).
- Install the plugin from WordPress.org and enter the credentials it asks for in its settings (API key, site ID, a staff login used to request its token). The author documents the setup on mZoo.org.
- Add its shortcodes to your pages, then style the output with your theme’s CSS or template overrides.
What you gain: the schedule is real HTML in your page, styled by your theme and readable by Google.
What you don’t: when someone clicks “Sign up”, the plugin sends them to Mindbody to log in, pay and confirm. The part of the journey that converts, and the part you would want to measure, still happens outside your site. Mindbody also bills API usage beyond a free allowance; check the current terms on the developer portal.
Choose this if you mainly want a nice, indexable timetable on WordPress and booking volume is modest.
Method 3: a custom integration on the Mindbody API
The third way keeps Mindbody exactly where it is (schedule, clients, pricing options, payments, reports) and replaces only what your members see. In practice, it is a custom WordPress plugin that talks to the Mindbody Public API (v6) from your server and renders the whole journey in your theme:
- the schedule, with your filters (studio, coach, class type);
- the class page, with pick-a-spot if your rooms need it;
- the cart and checkout, including 3-D Secure and, if you want, pay in 3 or 4 with Alma;
- the member area: credits, memberships, upcoming bookings, referral link.
Bookings and sales are written back to Mindbody, so the front desk sees the visits and your reports stay accurate.
What a serious integration has to handle:
- Credentials on the server only. The API key and staff token never reach the browser.
- Caching. The schedule is cached for a short time and refreshed after each booking, so pages stay fast and API calls stay under control.
- A real test mode. Mindbody can validate a cart without charging it, so you can test the whole journey on a staging site before launch.
- Tracking.
view_item,add_to_cart,begin_checkoutandpurchaseevents, with their value, pushed to GA4 and usable by Google Ads. - Maintenance. The Mindbody API evolves; someone has to watch errors in production and adapt.
A real example. For STAT Modern Health, a US clinic network running on WordPress, we built appointment booking as a WordPress plugin connected to Mindbody: need, location, provider, time, confirmation, in five steps, inside the site’s own theme. You can see the screens on our Mindbody WordPress plugin page.
Choose this if booking is central to your revenue, you invest in ads, or the iframe is visibly costing you members at checkout.
How to decide in two minutes
- You only need a timetable online: method 1 or 2.
- You want the timetable in your design and indexable by Google: method 2.
- You want people to book and pay without leaving your site, in your brand, with sales you can measure: method 3.
If you are weighing the plugins against each other, our guide to Mindbody WordPress plugins compares them in detail. And if you would like a second opinion on your current setup, we audit booking pages for free: send us the URL.