Title: Interactive Ratings for Contact Form 7
Author: hell0bunny
Published: <strong>September 25, 2026</strong>
Last modified: September 25, 2026

---

Search plugins

![](https://ps.w.org/hbwa-interactive-ratings-for-contact-form-7/assets/banner-772x250.
png?rev=3713124)

![](https://ps.w.org/hbwa-interactive-ratings-for-contact-form-7/assets/icon-256x256.
png?rev=3713124)

# Interactive Ratings for Contact Form 7

 By [hell0bunny](https://profiles.wordpress.org/hell0bunny/)

[Download](https://downloads.wordpress.org/plugin/hbwa-interactive-ratings-for-contact-form-7.1.0.0.zip)

 * [Details](https://wordpress.org/plugins/hbwa-interactive-ratings-for-contact-form-7/#description)
 * [Reviews](https://wordpress.org/plugins/hbwa-interactive-ratings-for-contact-form-7/#reviews)
 *  [Installation](https://wordpress.org/plugins/hbwa-interactive-ratings-for-contact-form-7/#installation)
 * [Development](https://wordpress.org/plugins/hbwa-interactive-ratings-for-contact-form-7/#developers)

 [Support](https://wordpress.org/support/plugin/hbwa-interactive-ratings-for-contact-form-7/)

## Description

**HBWA Interactive Ratings for Contact Form 7** adds a polished `[hbwa_starrating]`
form-tag so visitors can rate products, services, or support experiences in one 
click.

This plugin is an independent add-on. It is not affiliated with or endorsed by Rock
Lobster Inc. (the makers of Contact Form 7).

**Why it stands out**

 * Smooth hover preview with pop animation on select
 * Five color themes: Gold, Ember, Ocean, Forest, Mono
 * Four sizes from compact to extra large
 * Optional half-star ratings
 * Live text labels (Poor  Excellent)
 * Keyboard accessible (arrow keys, Home / End)
 * Mail-friendly output: `★★★★☆ (4/5) — Very good`
 * Live preview inside the Contact Form 7 tag generator
 * Works with CF7 Tag Generator v2 (no deprecation notices)

**Example form-tag**

    ```
    [hbwa_starrating* your-rating max:5 theme:ember size:lg half clear]
    ```

Then include `[your-rating]` in your Mail template.

**Tag options**

 * `max:1`–`max:10` — number of stars (default 5)
 * `theme:gold|ember|ocean|forest|mono`
 * `size:sm|md|lg|xl`
 * `half` — allow half-star steps
 * `clear` — show a clear button
 * `nolabel` — hide the live label text
 * `default:3` — pre-selected value

**Requirements**

 * [Contact Form 7](https://wordpress.org/plugins/contact-form-7/) must be installed
   and active

Author: [hell0bunny](https://profiles.wordpress.org/hell0bunny/)

## Screenshots

[⌊A contact form with a gold star rating, the live “Very good” label, and a clear
button.⌉⌊A contact form with a gold star rating, the live “Very good” label, and
a clear button.⌉[

A contact form with a gold star rating, the live “Very good” label, and a clear 
button.

[⌊Gold, Ember, Ocean, Forest, and Mono themes, with different sizes and a half star.⌉⌊
Gold, Ember, Ocean, Forest, and Mono themes, with different sizes and a half star
.⌉[

Gold, Ember, Ocean, Forest, and Mono themes, with different sizes and a half star.

[⌊The star rating form-tag generator in Contact Form 7, including the live preview
and the tag that will be inserted.⌉⌊The star rating form-tag generator in Contact
Form 7, including the live preview and the tag that will be inserted.⌉[

The star rating form-tag generator in Contact Form 7, including the live preview
and the tag that will be inserted.

[⌊The Mail template mail-tag next to the rating text that arrives in the inbox.⌉⌊
The Mail template mail-tag next to the rating text that arrives in the inbox.⌉[

The Mail template mail-tag next to the rating text that arrives in the inbox.

## Installation

 1. Upload the `hbwa-interactive-ratings-for-contact-form-7` folder to `/wp-content/
    plugins/`
 2. Activate **HBWA Interactive Ratings for Contact Form 7** through the **Plugins**
    screen
 3. Edit a Contact Form 7 form
 4. Click the **star rating** button in the form-tag generator
 5. Insert the tag and add the matching mail-tag to your Mail tab

## FAQ

### Is this an official Contact Form 7 plugin?

No. It is an independent add-on. It is not affiliated with or endorsed by Rock Lobster
Inc., the makers of Contact Form 7.

### How do I add a rating to a form?

Edit the form, click **star rating** in the form-tag generator, set the options,
and insert the tag. Then put the matching mail-tag, such as `[your-rating]`, in 
the Mail template.

### How do I make the rating required?

Check **Required field** in the generator, or add an asterisk to the tag name: `[
hbwa_starrating* your-rating]`. An empty required rating uses Contact Form 7’s standard
required-field message.

### Can I use more than one rating on the same form?

Yes. Give each field its own name, for example `[hbwa_starrating quality-rating]`
and `[hbwa_starrating support-rating]`, and add both mail-tags to the Mail template.

### Which themes and sizes are available?

Themes: `gold`, `ember`, `ocean`, `forest`, and `mono`. Sizes: `sm`, `md`, `lg`,
and `xl`. Example: `[hbwa_starrating your-rating theme:ocean size:lg]`.

### Do half-stars work?

Yes. Turn on **Allow half-star ratings**, or add `half` to the tag. Visitors can
then choose steps of 0.5, and a half-filled star is shown.

### What do the text labels say?

On a 5-star scale they are Poor, Fair, Good, Very good, and Excellent. The words
appear beside the stars while the pointer is over them or while the rating is focused.
A half-star uses the nearest whole-number label. Scales other than 5 use “1 star”,“
2 stars”, and so on.

### Can I change the label words?

Not from the tag generator. Use `nolabel` (or **Hide live label text**) if you do
not want the words shown. The email still includes the default label for that score.

### Can I pre-select a rating?

Add `default:` to the tag, for example `[hbwa_starrating your-rating default:4]`.
The value must fit the scale and the half-star setting.

### How many stars can I show?

From 1 to 10, with `max:`. The default is 5.

### How does the rating appear in email?

The mail-tag is replaced with stars, the score, and the label. A whole score looks
like `★★★★☆ (4/5) — Very good`. A half score looks like `★★★½☆ (3.5/5) — Very good`.

### Is the rating stored anywhere besides the email?

This plugin does not create its own ratings table. Contact Form 7 sends the formatted
text in the email. The value posted with the form is the number (for example `4`
or `3.5`). Plugins that save Contact Form 7 submissions will store that number.

### Can visitors use a keyboard?

Yes. Focus the rating and use the arrow keys to move by one step (or half a step
when half-stars are on). Home selects the lowest score and End selects the highest.

### What happens if Contact Form 7 is deactivated?

The plugin shows an admin notice and does not register its form-tag until Contact
Form 7 is active again. It cannot be activated on its own.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Interactive Ratings for Contact Form 7” is open source software. The following 
people have contributed to this plugin.

Contributors

 *   [ hell0bunny ](https://profiles.wordpress.org/hell0bunny/)

[Translate “Interactive Ratings for Contact Form 7” into your language.](https://translate.wordpress.org/projects/wp-plugins/hbwa-interactive-ratings-for-contact-form-7)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/hbwa-interactive-ratings-for-contact-form-7/),
check out the [SVN repository](https://plugins.svn.wordpress.org/hbwa-interactive-ratings-for-contact-form-7/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/hbwa-interactive-ratings-for-contact-form-7/)
by [RSS](https://plugins.trac.wordpress.org/log/hbwa-interactive-ratings-for-contact-form-7/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.0

 * Initial release: `[hbwa_starrating]` with themes, sizes, half-stars, labels, 
   keyboard a11y, and mail formatting

## Meta

 *  Version **1.0.0**
 *  Last updated **2 days ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.0 or higher **
 *  Tested up to **7.1.2**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [contact form 7](https://wordpress.org/plugins/tags/contact-form-7/)[feedback](https://wordpress.org/plugins/tags/feedback/)
   [rating](https://wordpress.org/plugins/tags/rating/)[review](https://wordpress.org/plugins/tags/review/)
   [star rating](https://wordpress.org/plugins/tags/star-rating/)
 *  [Advanced View](https://wordpress.org/plugins/hbwa-interactive-ratings-for-contact-form-7/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/hbwa-interactive-ratings-for-contact-form-7/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/hbwa-interactive-ratings-for-contact-form-7/reviews/)

## Contributors

 *   [ hell0bunny ](https://profiles.wordpress.org/hell0bunny/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/hbwa-interactive-ratings-for-contact-form-7/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://profiles.wordpress.org/hell0bunny/)