> For the complete documentation index, see [llms.txt](https://docs.moregoodreviews.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.moregoodreviews.com/importing/reviews.md).

# Reviews

Bring existing reviews into MGR from Google My Business, public review pages, CSV upload, or manual entry.

If you have reviews, ratings, or feedback on Google, Facebook, Yelp, or other sites, you can bring them into MGR so they appear in your dashboard and on your [Showcase](/platform/showcase.md). This page explains where to find the import options and how each method works. **The best way to import Google reviews is the Google My Business integration**—it syncs automatically and keeps your ratings and feedback up to date, helping you manage your reputation in one place.

### Where to Import

Go to **Reviews** in the sidebar and click **Add**. If you have no reviews yet, you can also click **Import Reviews**. A modal opens with three tabs: **Quick Import**, **Manual Entry**, and **Upload CSV**. For Google reviews, you can also connect **Google My Business** under **Settings > Integrations**.

***

### Google My Business (Recommended for Google Reviews)

The Google My Business integration is the best way to import and manage your Google reviews. It syncs your reviews automatically and keeps them up to date—no manual imports or URL pasting. Your ratings and feedback from Google appear in MGR, and you can reply to reviews directly from your dashboard.

**How it works:**

1. Go to **Settings** in the sidebar and click **Integrations**.
2. Find **Google My Business** under Review Integrations and click **Connect**.
3. Sign in with your Google account and authorize the connection.
4. Choose which business locations to sync. Reviews from those locations are imported and kept up to date.
5. Click **Sync** or **Resync** anytime to pull in the latest reviews.

{% hint style="info" %}
**Sync** and **Resync** keep loading reviews from Google until your project is caught up with what is already stored, then they stop. If you have a long review history on Google, the first sync after connecting or a full resync may take a little longer, but it runs in the background.
{% endhint %}

Once connected, new Google reviews appear in MGR automatically. You can reply to them, assign tags, filter by location, and display them on your [Showcase](/platform/showcase.md). Reviews stay in sync, so you always have the latest ratings and feedback in one place.

{% hint style="success" %}
Google My Business is the recommended method for importing Google reviews. It syncs automatically, supports multiple locations, and lets you reply to reviews from MGR—so you can manage your reputation without switching between tools.
{% endhint %}

{% hint style="info" %}
If you have multiple locations, select which ones to sync when connecting. Reviews will be tagged by location so you can filter and report by store or branch.
{% endhint %}

***

### Quick Import (from a Website URL)

Import reviews directly from a public review page. Paste the URL and MGR will fetch the reviews for you. Use this when you don't have the Google My Business integration, when importing from Facebook, Trustpilot, Yelp, or LinkedIn, or when the reviews live on another public website.

**Supported sites:** Google, Facebook, Trustpilot, Yelp, LinkedIn, and **Other Website** for any public reviews page.

**Steps:**

1. Go to **Reviews** and click **Add**.
2. Open the **Quick Import** tab.
3. Under **Scrape a Website**, choose the review site. Pick **Other Website** if the page is not Google, Facebook, Trustpilot, Yelp, or LinkedIn.
4. Paste the URL of your business's review page. The placeholder shows the expected format, such as a Google Maps place URL or a public `/reviews` page.
5. If you chose **Other Website**, you can pick a source or leave it blank so MGR detects it from the website.
6. If you use locations, optionally assign the imported reviews to a location.
7. For Google, Facebook, Trustpilot, Yelp, and Other Website, you can check **Positive only** to import only 4- and 5-star reviews.
8. Click **Import Recent Reviews**.

The import runs in the background. You'll see a confirmation when it's scheduled. Reviews appear in your list shortly after. You may receive an email when the import completes.

{% hint style="info" %}
For Google reviews, prefer the [Google My Business integration](#google-my-business-recommended-for-google-reviews) for automatic, ongoing sync. Quick Import from a URL is a one-time fetch.
{% endhint %}

**Other Website** imports reviews from a public page that does not have its own importer. It is a one-time fetch and does not keep syncing new reviews from that site.

MGR only imports customer reviews that already show a **1 to 5 star** rating and a real date from the **last 2 years**. The page must be public (no sign-in). Rating-only reviews are included. Reviewer name, company, photo, and review text are imported when they are on the page. Q\&A, comments, forum posts, testimonials without a star rating, thumbs-up, and replies are skipped.

If you leave **Source** blank, MGR detects the site name from the page and creates a source if you do not already have one. New sources use the site's favicon for the icon and color. You can change those later in **Settings > Sources**.

Reviews from Other Website are stored with the reviewer name. They are not customers you can email or text. Running the same URL again updates matching reviews instead of creating duplicates. There is a daily limit on how many times you can import from the same source.

{% hint style="warning" %}
The URL must point to a public reviews listing, not a homepage or a page that requires a sign-in. If you paste a Google, Facebook, Trustpilot, Yelp, or LinkedIn listing, choose that site instead of Other Website. If the page structure changes or the site blocks the import, the import may fail. You'll receive an email if that happens.
{% endhint %}

***

### Manual Entry

Add one review at a time. Enter the customer's name, contact info, rating, review text, date, and optionally the source, location, and tags.

**Steps:**

1. Go to **Reviews** and click **Add**.
2. Open the **Manual Entry** tab.
3. Fill in the customer section (first name, last name, email, phone, company).
4. Fill in the review section (rating, review text, date, source, location, tags).
5. Click **Save**.

The review appears in your list immediately.

{% hint style="info" %}
Manual entry is ideal when you have a few reviews or want to add one quickly. For larger batches, use Quick Import or CSV upload.
{% endhint %}

***

### CSV Upload

Upload a CSV file to import up to 1,000 reviews at once. The import runs in the background; you'll see a confirmation when it's scheduled. Reviews appear in your list shortly after. You may receive an email when the import completes.

**Steps:**

1. Go to **Reviews** and click **Add**.
2. Open the **Upload CSV** tab.
3. Click **Download Template** to get a sample file with the correct headers.
4. Fill in your data and save as CSV (UTF-8).
5. Click **Upload CSV** and select your file.

**CSV Headers**

| Header      | Required | Description                                                                            |
| ----------- | -------- | -------------------------------------------------------------------------------------- |
| first\_name | Yes      | The reviewer's first name.                                                             |
| last\_name  | No       | The reviewer's last name.                                                              |
| email       | No       | The reviewer's email address.                                                          |
| phone       | No       | The reviewer's phone number.                                                           |
| company     | No       | The reviewer's company name.                                                           |
| score       | Yes      | The rating (1–5).                                                                      |
| review      | No       | The review text.                                                                       |
| source      | No       | The slug or UUID of a source. Must match a source in **Settings > Sources**.           |
| location    | No       | The slug or UUID of a location. Must match a location in **Settings > Locations**.     |
| tags        | No       | Comma-separated list of tag slugs. Tags must exist in your project and be for reviews. |
| created\_at | No       | The date of the review. Use YYYY-MM-DD format.                                         |

**What happens during import:** Each row creates or finds a customer (by email or phone) and attaches a review to them. If the customer already exists, the review is added to their profile. If not, a new customer is created.

{% hint style="warning" %}
Each row must have either an email or a phone number so MGR can associate the review with a customer. Without a way to identify the reviewer, the import may skip or fail for that row.
{% endhint %}

{% hint style="info" %}
Download an example CSV template from [moregoodreviews.com/csv/reviews.csv](https://moregoodreviews.com/csv/reviews.csv).
{% endhint %}

***

### After Import

* **Google My Business** – Reviews sync automatically. New reviews appear in MGR as they come in. Use **Sync** or **Resync** on the integration page to pull the latest data.
* **Quick Import** – The import runs in the background. You may receive an email when it completes. Reviews appear on the Reviews page as they are processed.
* **CSV Upload** – Same as Quick Import. The import is scheduled and runs in the background.
* **Manual Entry** – The review appears immediately.

Once reviews are in your project, they appear in your [Showcase](/platform/showcase.md), widgets, and analytics. You can reply to them, assign tags, or filter by location.

***

### Tips

{% hint style="success" %}
Connect **Google My Business** first if you have Google reviews. It's the easiest way to import and manage your reputation—reviews sync automatically and you can reply from MGR.
{% endhint %}

{% hint style="success" %}
Use the **Positive only** option when importing from Google, Facebook, Trustpilot, Yelp, and Other Website if you want to focus on 4- and 5-star reviews for your showcase or marketing.
{% endhint %}

{% hint style="info" %}
If you have multiple locations, assign a location when importing so you can filter and report by location later.
{% endhint %}

{% hint style="info" %}
Tags in the CSV must use tag slugs (the URL-friendly name) and must already exist in your project under Settings > Tags. Use comma-separated values for multiple tags. Tags must be for reviews, not customers.
{% endhint %}
