Skip to main content

Customizing your Write a review flow

Customize the form used for submitting reviews in-store or via email links.

Updated over a week ago

Help your customers leave better reviews by customizing your review form appearance and content across all touch points.


How it works

In-store review form

When a customer clicks the Write a review button from the Review Widget on your product page, they’ll go through the new Judge.me form—a guided, step-by-step experience designed for better focus and higher completion rates.

Here’s how the default In-store review form works:

  1. Star rating screen: The form first asks the customer to select a star rating for the product. Once selected, the form will automatically move to the next screen.

  2. Review content screen: The form will then ask for a written feedback (required). Once done, the customer can click Next to continue or Back to go back.

  3. About you screen: The form then collects the customer's email address and display name (required). The customer can also choose to post anonymously. Once done, the customer can click Next to continue or Back to go back.

  4. Media upload screen: The form then encourages the customer to upload photos, videos, or paste a YouTube URL to support the review. Once done, the customer can click Next to continue or Back to go back.

  5. Review submitted screen: The customer will be prompted to confirm their email. The customer can click the Close button to finish.

External review form

When a customer clicks the review link in the review request emails, they’ll either go through the In-store review form on your product page or the external review form on a Judge.me-hosted page.

Here's how the default Judge.me external review form works:

  1. Star rating screen: The form first asks the customer to select a star rating for the product. Once selected, the form will automatically move to the next screen.

  2. Review content screen: The form will then ask for a written feedback (required). Once done, the customer can click Next to continue.

  3. About you screen: The form then collects the customer's display name (required). The customer can also choose to post anonymously. Once done, the customer can click Next to continue.

  4. Media upload screen: The form then encourages the customer to upload photos, videos, or paste a YouTube URL to support the review. Once done, the customer can click Next to continue.

  5. Review submitted screen: The customer will be prompted to confirm their email. The customer can click the Go to store button to finish.


Considerations

  • In the In-store review form:

    • The X icon to close the form only shows on the Star rating screen. After that screen, customers can either continue through the form or refresh the page to exit.

  • In the Judge.me external form:

    • The light mint green background color of the Judge.me-hosted page cannot be customized.

  • At the bottom of the Review content screen in both forms, we show this GDPR statement: "We'll only contact you about your review if necessary. By submitting your review, you agree to our terms and conditions and privacy policy". This disclaimer cannot be removed or edited, as it ensures transparency and compliance with data protection requirements.

  • An email address is required when submitting a reviews and can’t be made optional.


Customize the text and styling of the form

1. Texts

Available on the Awesome plan

To customize the texts in your Write a review form:

  1. Under each section below, adjust the texts to your liking.

  2. Click Save.


Review content

Field

Default texts

Screen title

How would you rate this product?

Introduction

We would love it if you would share a bit about your experience.

1 star review guidance

Poor

5 star review guidance

Great

Review title

Review title

Review title placeholder

Give your review a title

Review content

Review content

Review content placeholder

Start writing here...


Customer information

Field

Default texts

Screen title

About you

Introduction

Please tell us more about you

Reviewer display name

Display name

Reviewer display name placeholder

Display name

Reviewer email address

Email address

Reviewer email address placeholder

Your email address

Label for hidden customer name

Anonymous


Reviewer media

Field

Default texts

Screen title

Share a picture or video

Introduction

Upload a photo or video to support your review.

YouTube URL placeholder

Paste your YouTube URL here


Custom questions

Option

Default text

Screen title

Your experience in more detail

Introduction

Here are a few questions to help us understand more about your experience.


Store review

Option

Default text

Screen title

Would you like to share your experience of shopping with us?

Introduction

We value your feedback and use it to improve. Please share any thoughts or suggestions you have.

Note: You can enable the option to collect a store review after a product review in the Submission flow.


Review submitted

Field

Default texts

Review submitted screen title

Thanks for your review!

Thank you message

We are processing it and it will appear on the store soon.

Email verification message

Please confirm your email by clicking the link we just sent you. This helps us keep reviews authentic.


Negative review resolution

Field

Default texts

Screen title

Tell us more

Negative review resolution

Your experience matters to us. If there were issues with your purchase, we're here to help. Feel free to reach out to us, we'd love the opportunity to make things right.

Button text

Contact us


Advanced settings

Field

Default texts

Next step button text

Next

Close review button text

Close


2. Colors

To choose a color scheme for the review form:

  1. From your Judge.me admin, go to Settings > Widgets > Write a Review.

  2. Open the Form Styling section.

  3. For Color scheme, select one the following options:

    • "Default colors (from your brand settings)" — to use the same Primary color from your Branding setting.

    • "Custom colors" — to pick colors for these elements of the form:

      • "Star color" (available on the Free plan)

      • "Text color" (available on the Awesome plan)

      • "Form background color" (available on the Awesome plan)

      • "Field background color" (available on the Awesome plan)

      • "Button color" (available on the Awesome plan)

      • "Button text color" (available on the Awesome plan)

      • "In-store page overlay color" (available on the Awesome plan)

  4. Click Save.

3. Corner style

Available on the Awesome plan

To adjust the corner style of the review form (applied to background card, input fields, and buttons):

  1. From your Judge.me admin, go to Settings > Widgets > Write a Review.

  2. Open the Form Styling section.

  3. Open the Background card, input field and button dropdown.

  4. Select one of the following options:

    • "Square"

    • "Soft"

    • "Round"

    • "Extra round"

  5. Click Save.


Customize the submission flow

1. Quick star ratings

Available on the Free plan

To allow customers to submit a review with only star ratings, without needing to write a comment:

  1. From your Judge.me admin, go to Settings > Widgets > Write a Review.

  2. Scroll down and open the Submission flow section.

  3. Click the checkbox next to "Enable quick star ratings".

  4. Click Save.

Once enabled, the Review content field remains visible in the review form but becomes optional.

2. Review title

Available on the Free plan

To allow customers to add a review title when writing a review:

  1. From your Judge.me admin, go to Settings > Widgets > Write a Review.

  2. Scroll down and open the Submission flow section.

  3. Click the checkbox next to "Ask for review title".

  4. Click Save.

Once enabled:

  • An optional Review Title field will be added below the Review Content field.

  • As the customer types their review content, the Review Title field will be automatically filled with the first 50 characters of the content.

  • The customer can manually edit the title if they wish.

3. Review media

Available on the Free plan

To allow customers to review images and/or videos when writing a review:

  1. From your Judge.me admin, go to Settings > Widgets > Write a Review.

  2. Scroll down and open the Submission flow section.

  3. To allow image upload: click the checkbox next to "Ask for review images" .

  4. To allow video upload: click the checkbox next to "Ask for review videos"

  5. (Optional) Click the checkbox next to "Mute videos by default".

  6. Click Save.


Customize the flow from review request emails

1. Choose which form to use

Available on the Free plan

To choose where customers leave a review after clicking the link in the review request emails:

  1. From your Judge.me admin, go to Settings > Widgets > Write a Review.

  2. Scroll down and open the Collection via email request section.

  3. In the Redirect reviewers invited via email to dropdown, choose one of the following:

    • "External form (recommended)" – Directs reviewers to the Judge.me-hosted review collection page

    • "In-store review form" – Directs reviewers to the review form on your product page

  4. Click Save.

2. Add post-review prompts

Available on the Awesome plan

If you select "External form (recommended)", you can also collect more reviews after a customer has submitted an initial product review:

  1. From your Judge.me admin, go to Settings > Widgets > Write a Review.

  2. Scroll down and open the Collection via email request section.

  3. Open the Redirect reviewers invited via email to dropdown.

  4. Select "External form (recommended)".

  5. In Post review prompts, check the box next to "Ask reviewer to review other products in the order" to collect reviews for other products.

  6. Click Save.

Example:


Troubleshoot


"This field is required" error

When writing a review, if your customer run into the "This field is required" error even though they have filled in the star rating and the body of the review, it might be because the Review Widget is duplicated on the product page, which causes form conflicts and prevents proper validation.

To avoid the "This field is required" error from showing when both the star rating and body have been filled in, double-check and remove the duplicated Review Widget.


"inputLabels.widgetSubmitReviewText" error

If the preview of your external review form looks like the screenshot above (showing placeholder texts such as reviewPageText.whatDoYouThinkAboutProductText or inputLabels.widgetSubmitReviewText instead of the proper field labels and buttons), or if customers see the inputLabels.widgetSubmitReviewText texts when trying to upload a photo or video, it usually means you're using the Legacy styling template together with the external form.

To check if you're using the Legacy styling template:

  • From your Judge.me admin, go to Settings > Email templates.

  • Under Review request and reminder emails, check if the Legacy styling template is "On".

The Legacy styling template doesn’t work well with the external review form. To fix this, you can either:

  • Keep using the Legacy styling template, but switch to the in-store review form instead of the external form.

  • Keep using the external form, but change your email templates to the Smart styling template (recommended).


Star icons not showing in the Star rating screen

In the Star rating screen of both your In-store review form and Judge.me external review form, if you only see the “Poor — Great” labels without any clickable star icons, it's likely that the star icons were set to the same color as the form background.

To make sure the star icons are visible in the Star rating screen of both your In-store review form and Judge.me external review form:

  1. First, check which color scheme you're using for your review form:

    • From your Judge.me admin, go to Settings > Widgets > Write a Review.

    • Open the Form Styling section.

    • For Color scheme, check whether "Default colors (from your brand settings)" or "Custom colors" is selected.

  2. If "Default colors (from your brand settings)" is selected, make sure your Primary color is not set to white:

    • From your Judge.me admin, go to Settings > Branding.

    • In the Color section at the top, if the Primary color field is set to white, change it to a more visible color.

    • Click Save.

  3. If "Custom colors" is selected, make sure your Star color is not set to the same color as your Form background color:

    • From your Judge.me admin, go to Settings > Widgets > Write a Review.

    • Open the Form Styling section.

    • For Custom colors, set a different color for either the Star color or Form background color

    • Click Save.


Did this answer your question?