Add extra required agreements, house rules, a pet policy, HOA rules, to checkout, each with its own checkbox and, if you want, a typed or drawn signature.
What it does #
Some properties need guests to acknowledge more than the standard rental agreement, house rules, a pet policy, community rules, quiet hours. Checkout Agreements adds extra agreement blocks to checkout, each with its own required checkbox, separate from your plugin’s built-in rental agreement. You can also require a signature, typed or drawn, on the rental agreement itself.
While an agreement block is empty, it does nothing. Each block only appears on checkout once you have filled in both its agreement text and its checkbox label, so writing it and turning it on are the same step.
What the guest experiences:
- A card appears on checkout for each agreement you have configured, with its heading (if you set one), your agreement text, and a checkbox.
- They cannot submit the reservation until every box is checked. If they try, a warning appears, starting with your Rental Agreement if it is not yet accepted, then each of your agreement cards in the order they appear on the page, and the page scrolls to the one they still need to accept.
- If you turned on a signature for a card, they also have to type their full name or initials, or draw their signature with a finger or mouse, before checkout can proceed.
- Their acceptance, and their signature if you collected one, is recorded on the reservation notes, so you have a record tied to that specific booking.
How to turn it on #
1. Open the module #
In the HomeRunner Toolkit Hub, switch on Checkout Agreements.
2. Add an agreement #
Click + Add agreement. Fill in Agreement Text with what the guest needs to agree to, using the Visual editor for formatting or the Code tab to edit the HTML directly, and Checkbox Label with the text shown next to the required checkbox, for example “I have read and agree to the House Rules.” These two fields are what activate the card, leave either blank and it stays off checkout.
3. Optional: title, warning, and signature #
Add a Title if you want a heading above the text, for example “House Rules” or “Pet Policy.” Leave Warning Message blank for an automatic one built from your title, or write your own. Turn on Signature Field if you also want guests to sign, choosing none, a typed full name, typed initials, or a drawn signature.
4. Repeat for as many agreements as you need #
Click + Add agreement again for a second, third, or further agreement, each with its own text, checkbox, and signature setting. You can add up to 20 agreements, more than enough room for any real checkout.
5. Optional: require a signature on your Rental Agreement #
At the top of the same settings panel, the Rental Agreement (built-in) box lets you require a signature, typed or drawn, on your plugin’s own Rental Agreement checkbox, without adding a separate card. Pick a Signature Field option there and save. This only applies on properties that already show a Rental Agreement at checkout.
Settings #
Rental Agreement (built-in) #
| Setting | What it controls |
|---|---|
| Signature Field | Whether guests must also sign your plugin’s built-in Rental Agreement, in addition to its checkbox. None (default), typed full name, typed initials, or a drawn signature. Only applies when the property shows a Rental Agreement. |
| Signature Label | Label shown above the signature input. Leave empty for an automatic label based on the signature type. |
Each agreement #
| Setting | What it controls |
|---|---|
| Title | Optional heading shown above the agreement text, e.g. “House Rules.” Leave empty for no heading. |
| Agreement Text | The agreement itself, written in the Visual editor or edited directly as HTML in the Code tab. Required, along with Checkbox Label, for this agreement to appear on checkout at all. |
| Checkbox Label | The text shown next to the required checkbox. |
| Warning Message | Shown when a guest tries to submit without checking the box. Leave empty for an automatic message built from the title. |
| Signature Field | None (checkbox only), typed full name, typed initials, or a drawn signature. |
| Signature Label | Label shown above the signature field. Leave empty for an automatic label based on the signature type chosen. |
Tips #
- Drawn signatures are captured as an image and stored on your site. Turn on Form Entries to keep the image on file and view it: open the entry on the Entries screen and a Signatures section shows each stored signature inline, with a button to download it as a PNG. Without Form Entries, the acceptance is still recorded on the reservation notes, just without an image to view later.
- Once a guest completes checkout, the entry on the Entries screen is linked to the resulting reservation, so a signed agreement is never just a name and a timestamp, you can trace it straight to the booking it belongs to. An entry that never picks up a reservation represents a checkout the guest started but did not finish.
- The agreement and signature are recorded together on the reservation’s notes, so you can see exactly what a guest agreed to, and how they signed, on that booking.
- If you also collect other checkout information, see Checkout Survey for gathering custom questions and answers at booking time.
- If a checkbox is missing from checkout after you configure an agreement, double check that both Agreement Text and Checkbox Label are filled in. An empty field on either one keeps that card hidden.
- If your site already shows a Rental Agreement card at checkout, its warning appears first when a guest has not accepted it, keeping messages in the same top-to-bottom order as the cards on the page.