Description
Swaranan Guest Selector for Contact Form 7 extends Contact Form 7 by adding an advanced Guests selector suitable for hotel bookings, tours, reservations, events, and travel forms.
Instead of a simple number field, users can:
- Select total guests
- Choose Adults and Children separately
- Optionally enable age fields for each child
- Automatically validate totals
- Send structured guest data through Contact Form 7 emails
The plugin integrates directly into the Contact Form 7 form editor with its own tag generator button.
Features
- Adds a custom Guests field type to Contact Form 7
- Adults & Children selector UI
- Optional child age fields
- Configurable minimum and maximum guests
- Required field support
- Mobile-friendly UI
- Optional first dropdown label using
first_as_label - Validation for total guest count
- Mail tags support
- Easy shortcode/tag generator inside Contact Form 7 editor
Example Form Tag
[guest_selector* guests min:1 max:10 label:Total label:Guests first_as_label child_ages]
Available Mail Tags
[guests]
[guests_adults]
[guests_children]
[guest-selector-summary]
Example Output
Guests: 4
Adults: 2
Children: 2
Child Ages: 5, 8
License
This plugin is licensed under the GPLv2 or later.
Screenshots



Installation
- Upload the plugin files to the
/wp-content/plugins/swaranan-guest-selector-for-contact-form-7directory, or install the plugin through the WordPress plugins screen. - Activate the plugin through the “Plugins” screen in WordPress.
- Make sure Contact Form 7 is installed and activated.
- Edit a Contact Form 7 form.
- Click the new “Guests” button in the form editor toolbar.
- Configure your field options and insert the tag.
FAQ
-
Does this plugin require Contact Form 7?
-
Yes. Contact Form 7 must be installed and activated.
-
Can I disable child age fields?
-
Yes. Simply omit the
child_agesoption from the form tag. -
Does it support required fields?
-
Yes. Use the required version of the tag:
[guest_selector* guests]
-
Can I limit the number of guests?
-
Yes. Use
min:andmax:options.Example:
[guest_selector guests min:1 max:8]
-
Can I show the label as the first dropdown option?
-
Yes. Add
first_as_labeland provide alabel:value.Example:
[guest_selector participants min:0 max:20 default:0 label:Number label:of label:Participants first_as_label]
Contributors & Developers
“Swaranan Guest Selector for Contact Form 7” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Swaranan Guest Selector for Contact Form 7” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.1.1
- Updated Child Age field placeholder.
- Updated screenshot
1.1.0
- Added Contact Form 7 tag generator button
- Added Guests field settings popup
- Improved frontend UI
- Added optional child age fields
- Added validation improvements
- Added mail tag support
1.0.0
- Initial release
