# Links

You can add links to 3rd party reviews sites to your review page. This is essential if you would like to get more good reviews on sites like Google, Facebook, Yelp, TripAdvisor, and more. Links appear on your review page as buttons, if the review is a positive one (typically a rating of 4 or 5, but you can customize this). If the review is not positive, by default, we will display a link revealer — a small button beneath the feedback form that gives the customer the option of leaving a public review.

### Link Anatomy

The buttons that appear on your review page are fully customizable. You can edit the following:

* **Source** - Google, for example. This is used to pre-fill the label, color, and icon.
* **Label** - The label of the button.
* **Color** - The color of the button.
* **Icon** - Choose from our icon library or upload your own image.\
  Specs: 1:1, max: 2mb, min size: 64px x 64px, max size: 1000px x 1000px

{% hint style="info" %}
Icons from MGR's library use the same wording rules as icons on tags and sources. If automation fills in icon text for you, use two lowercase words separated by one space (for example **fab fa-google** or **fas fa-star**).
{% endhint %}

* **Link** - The URL to the 3rd party review site.
* **Incentive** - An optional incentive to display underneath the button.

### Link Options

We give you full control over how the links are displayed to your customers.

* **Link Reveal Rating** - Reveal links if the customer picks a specific rating or higher. Otherwise, a small button to reveal the links will be shown (the link revealer).
* **Link Reveal Label** - The label of the button to reveal the links.
* **Link Reveal Timing** - Choose whether to show your links immediately after a rating is chosen, or on the success page, after a review has been submitted.
* **Link Reveal Button** - Choose whether or not to show the link revealer at all.

{% hint style="danger" %}
You can disable the option to direct your customers to leave public reviews if the rating is negative, but we do not recommend it. Preventing customers from leaving public reviews can get your 3rd party listings removed.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://docs.moregoodreviews.com/platform/review-pages/links.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
