The HomeRunner Toolkit includes a set of quiet background modules that improve your booking site’s reliability, accessibility, and security once you switch them on, with little or nothing to configure.
What it does #
A booking site has rough edges that guests notice but you rarely see: a cryptic error message at checkout, a logo that will not upload, a broken site icon on inner pages. The Toolkit ships several small modules that smooth over these problems. Each one is a single on or off switch in the Hub. Most have no settings screen at all: you turn the module on and it works. The one exception is Error Humanizer, which also gives you an editable message map (covered below).
These modules are off until you enable them, and you enable each one per site from the Hub. Once on, they run on their own with little or nothing further to configure.
What each module does for your guests:
- Error Humanizer. When something goes wrong during a quote or at checkout, the booking system can return terse, technical wording that confuses guests and makes them abandon. Error Humanizer replaces those messages, on the booking widget, the checkout page, and the property search and explorer pages, with plain, reassuring language that tells the guest what happened and what to do next. It catches both messages shown when the page loads and ones that appear after the guest interacts, so a cryptic failure rarely reaches the screen. This module also has a settings screen in the Hub: an editable message map where you can reword any of the replacement messages or add your own.
- Translation REST Fix. On sites that offer translated pages with plugins like WPML, Polylang, TranslatePress, or GTranslate, the translation plugin can insert a language prefix such as
/es/or/de/into the addresses the booking widget relies on. That broke actions like applying a coupon code, which then showed a generic “Internal error” message. This module strips those prefixes so the widget keeps working for guests browsing in any language. - Image Alt Filter. Images missing alt text hurt accessibility (screen-reader users cannot tell what an image shows) and SEO (search engines lose useful context). This module fills in missing or empty alt text from the alt text already stored with each image in your media library, working on the final page so it applies no matter which theme or page builder rendered the image. An image that has only a description and no stored alt text gets nothing, so it pays to keep the alt text field filled in on your key images.
- SVG Support. WordPress blocks SVG uploads by default because a raw SVG file can carry hidden malicious code, such as a script that runs when the image loads. SVG Support re-enables SVG uploads in your media library and cleans every file as it comes in, so you can use crisp vector logos and icons without the security exposure. The cleaning step rebuilds each file from a known-good list of drawing instructions, keeping the shapes, paths, gradients, text, and styling a real logo or icon needs and discarding anything else. Disguised or encoded scripts, links that point at code instead of an image, and the kind of file structure used to overload a server are refused outright.
- Favicon Normalizer. Your favicon is the small site icon shown in the browser tab and in saved bookmarks. On some sites the link to that icon is written in a way that works on the home page but breaks on inner pages, so the icon disappears or shows as broken once a guest clicks deeper. This module repairs those broken icon links in the page, removes empty icon links that point nowhere, and fixes links that load over an insecure address so they do not trigger a “not secure” warning. It only fixes the link to the icon and never changes the icon image itself.
For example, a guest browsing your /es/ Spanish pages enters a coupon code and, without Translation REST Fix, sees only “Internal error.” With the module on, the coupon applies normally.
Toolkit’s on-page widgets, such as the search bar, filter panel, guest picker, checkout screens, mobile map-first explorer sheet, and brand color skin, are also built to resist your theme’s or page builder’s own styling rules bleeding in and changing their colors, buttons, or spacing. This runs automatically for every one of those modules once you turn it on, with nothing to configure, and it is what keeps a theme like Elementor from quietly recoloring the Search button or breaking the layout of the guest picker.
How to turn it on #
1. Open the Hub #
In the HomeRunner Toolkit Hub, find the module you want in the module list.
2. Switch it on #
Turn on the module (for example Error Humanizer or SVG Support). For most of these modules the switch is the only control, and the module starts working right away on the front of your site. Error Humanizer is the exception: its Hub screen includes the editable message map, where you can reword any replacement message or add entries of your own. The defaults work well without touching it.
3. Repeat per site #
Each module is enabled per site, so switch on the ones you want on every site where you want them.
Settings #
| Setting | What it controls |
|---|---|
| Error Humanizer | On or off, plus an editable message map. When on, replaces technical error messages on the booking widget, checkout, and the search and explorer pages with plain guest-friendly wording; the message map lets you reword any message or add your own. Off by default. |
| Translation REST Fix | On or off. When on, strips translation-plugin language prefixes so the booking widget keeps working on translated pages. Off by default. |
| Image Alt Filter | On or off. When on, fills missing image alt text from each image’s stored alt text in the media library. Off by default. |
| SVG Support | On or off. When on, allows SVG uploads in the media library and cleans each uploaded file. Off by default. |
| Favicon Normalizer | On or off. When on, repairs broken, empty, and insecure favicon links in the page. Off by default. |
Tips #
- Reservations exported from Toolkit: Reservations Pro are written so a cell that begins with a spreadsheet formula character is kept as plain text, so a guest cannot smuggle a live formula into a downloaded reservation file. Numeric columns such as amounts and decimals stay numeric.
- If the booking widget shows “Internal error” only on your translated pages, turn on Translation REST Fix first; that prefix problem is the usual cause.
- If a theme or page builder update ever makes a Toolkit widget look off (wrong button color, broken spacing), it is worth a hard refresh first: the style protection is automatic and runs for every module, so a stale cached stylesheet is the more likely cause.
- For the modules you do configure, see the Toolkit Overview, Toolkit: Conversion Tracking, Toolkit: Guest Identity, and Toolkit: Booking Widget Math Reconcile.