> For the complete documentation index, see [llms.txt](https://help.meetmadison.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.meetmadison.ai/reputation/review-request-page.md). # Your review request page When you send a [review request](/reputation/review-requests.md), your customer gets a link. Opening it brings them to a simple, mobile-friendly page where they rate their experience and, depending on that rating, either leave a public review or share private feedback with you. Each request has its own unique link. This page explains what your customers see and the things you can control. ## What your customer sees 1. **Your logo**: if you've added one, it appears at the top of the page along with your business or location name. See [Brand](/settings/brand.md). 2. **A star rating**, a row of 1–5 stars under a short prompt (for example, "How was your experience?"). 3. **What comes next depends on the rating**: see below. The page is intentionally minimal: one screen, no account or login needed for your customer, and it works on phones, tablets, and desktop. ## How the rating decides what happens Every review request has a **rating threshold**. When a customer picks their star rating, the page compares it to that threshold: * **At or above the threshold** → the customer is invited to leave a **public review** on Google. They see a short message and a button that takes them to your Google review page. * **Below the threshold** → the customer is shown a **private feedback box** instead. What they write comes back to you and is **not** posted publicly. This means you can send every customer the same link while making it easy for happy customers to review you publicly, and giving less-happy customers a private way to tell you what went wrong. The wording adapts to the rating: a 5-star customer sees positive, celebratory copy, while a lower rating sees a more apologetic, "let us make it right" tone. {% hint style="info" %} Private feedback left below the threshold doesn't appear publicly anywhere. It comes back to you in Madison so you can follow up. {% endhint %} ### Where you set this up Open the **Requests** tab in Reputation and select the settings cog (⚙ **Set up review requests**). For each automation or shareable link, choose: * **Send customers to**: **Google** (*encourage public Google reviews*) or **Madison** (*collect private feedback in Madison*). Choosing Madison doesn't send the customer anywhere: a private feedback box opens right on the page, and their comments are stored for you in Madison. * **Minimum star rating**: when you send customers to Google, this is the threshold: customers who give this rating *or higher* are invited to leave a Google review, and everyone below it gets the private feedback box instead. If you choose **Madison**, every customer gets the private feedback box and no one is sent to a public review site. {% hint style="warning" %} Choosing **Google** needs a working Google connection. Requests set to send customers to Google won't send, whether automated or sent directly, until your [Google account is connected](/getting-started/connect-your-integrations.md) and your listing has a verified page with a valid review link. If you don't use Google, choose **Madison** instead. {% endhint %} ### The public review step When a customer is sent to leave a public review, they see a short message and a **Leave a review** button. Selecting it opens your Google review page. ### The private feedback step Customers below the threshold get a box to explain their experience. After they submit, they see a short thank-you message, and their feedback flows back to you in Madison. ## Pre-selecting a star from your message You can include the star rating *inside* the message you send, so the customer "votes" with a single click and lands on the page with that rating already applied. This is what powers the "tap a star in the email" experience. If you're building your own link, add `?rating=` followed by a number from 1 to 5 to the end of it: ``` https://hearsyou.co/?rating=5 ``` * A customer tapping the **5-star** version lands ready to leave a public review. * A customer tapping a **lower** star lands on the private feedback step. Ratings outside 1–5 are ignored, and customers can always change their selection on the page. ## Customising the wording Almost all of the text on the page can be tailored to your brand's voice. If you don't set custom wording, sensible defaults are used: * **Page title**: "Leave a review" * **Rating prompt**: "How was your experience?" * **Positive heading** (happy rating): "That's great to hear!" * **Negative heading** (lower rating): "We're sorry we didn't get it quite right" * **Ask for a public review**: "We'd really appreciate it if you could share your rating on Google…" * **Ask for positive feedback**: "We'd love to know what you liked." * **Ask for what went wrong**: "What could we have done better?" * **Feedback box placeholder** (positive): "What stood out?" * **Feedback box placeholder** (negative): "Tell us what happened…" * **Thank-you after positive feedback**: "Thanks for sharing, it means a lot to the team." * **Thank-you after negative feedback**: "Thanks for telling us. We'll use this to put it right." You edit this text from the **Requests** tab's settings cog (⚙ **Set up review requests**), under **page text**. Save it for **All locations** or **Per location**, and override it for an individual automation or link if you'd like different wording there. You can personalise it with tokens like `{locationName}`. ## Previewing before you send You can preview exactly what a customer will see, without recording any real ratings or feedback, by adding `?preview` to the end of a review request link: ``` https://hearsyou.co/?preview ``` In preview mode you can click through the stars, the public-review step, and the feedback form to check your branding and wording. Nothing you do in preview is counted or saved. {% hint style="warning" %} Preview only covers Madison's own pages. If you select the button through to Google, you're on Google's real review page, so anything you post there is live. Don't leave a test review on Google. {% endhint %} ## Things worth knowing * **No login for your customers.** Anyone with the link can use the page: keep that in mind when sharing links. * **One response per customer.** If the same customer comes back to the same link, Madison updates their existing response rather than recording them again. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.meetmadison.ai/reputation/review-request-page.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.