> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchski-attract.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Reviews connection

> Bring your Google reviews onto your site automatically, on a schedule you choose.

Your Google reviews can arrive on your site by themselves. Connect Google once, choose how often to check, and new reviews reach your site without any copying and pasting.

This connection brings reviews into the CMS; it doesn't put them on a page. To show them, add a Google Reviews section (a block of your reviews) to a page: see [Google Reviews section](https://docs.fetchski-attract.com/guides/sections/google-reviews.md).

&#x20;**Who can do this:** Admins and Owners.

![The Google Reviews card set up with Review provider "Business Profile API — OAuth, all reviews", the "Uses the Google Business Profile connection" note.](https://mintcdn.com/fetchski-attract-api/MsE85fjBwOCKqNGh/images/cms/guides/connections/google-reviews/guides-connections-google-reviews-card-light.png?fit=max\&auto=format\&n=MsE85fjBwOCKqNGh\&q=85\&s=546cabdf12aab9cb12c5b692b34df2b0)

The Google Reviews card, fetching every 12 hours.

## Choose where reviews come from

The card's **Review provider** offers two ways to fetch your reviews.

| | **Business Profile API — OAuth, all reviews** | **Places API (New) — API key, up to 5 reviews** |
| - | - | - |
| Reviews | All of them, up to your **Reviews to fetch** setting | Up to 5, as Google chooses |
| Several locations | Yes, every listing you manage | One listing |
| What you need | Your [Google Business Profile](https://docs.fetchski-attract.com/guides/connections/google-business-profile.md) connected | A Places API key with billing turned on, and your listing's Place ID |

Choose the Business Profile option if you can. It can reach all your reviews, not just 5, and it's the same connection you use to reply to reviews. How many actually arrive is up to two settings in step 5 below: the newest 50 per listing, and only 5-star reviews, until you change them.

The two options use different Google logins, and neither is your Google Maps key:

* **Business Profile option**: the sign-in connection on the **Google Business Profile** card. Nothing to paste here.
* **Places option**: its own key, pasted into **Places API key** on this card. It's private: the setup guide restricts it to the Places API (New) and to your site's server.
* **Google Maps key**: the separate, public key in **Maps JavaScript API key (public)** on the Google Maps card, for maps on your pages. See [Google Maps](https://docs.fetchski-attract.com/guides/connections/google-maps.md).

## Before you start

* For **Business Profile API — OAuth, all reviews**: connect your listing first. See [Google Business Profile](https://docs.fetchski-attract.com/guides/connections/google-business-profile.md).
* For **Places API (New) — API key, up to 5 reviews**: a Google Cloud account with billing turned on. Google needs a card on file. It includes a free monthly allowance.

## Set it up

**1. Open the card**

Open **Connections** from the toolbar or the command palette (⌘K, or Ctrl+K on Windows). The toolbar is the bar across the top of your site once you're signed in; see [The toolbar](https://docs.fetchski-attract.com/guides/get-started/toolbar-and-command-palette.md#the-toolbar). Under **Google**, choose **Google Reviews**.

**2. Pick the provider**

In **Review provider**, choose one of the two options.

* **Business Profile API — OAuth, all reviews**: a note, **Uses the Google Business Profile connection**, appears. There's nothing else to paste. Every listing with **Manage this profile** on brings in its reviews.
* **Places API (New) — API key, up to 5 reviews**: follow **Setup guide — Places API key** to create a key, and paste it into **Places API key**. Then follow **Finding the Place ID** and paste your listing's ID into **Place ID**. It starts with "ChIJ".

**3. Turn on the schedule**

Set **Enable scheduled sync** to **Yes**. There's no button to fetch reviews by hand: reviews arrive only through the schedule, so this switch is what brings them in.

**4. Choose how often**

Open **Advanced options**. **Fetch how often** appears there once the schedule is on. **Every 12 hours (recommended)** suits most businesses. You can choose from every 3 hours to every 48 hours.

**5. Choose which reviews to keep**

Still in **Advanced options**:

* **Minimum star rating to keep**: reviews below this rating are skipped and never stored. It starts at **5**, which keeps only 5-star reviews. Set it to 1 to keep every review.
* **Reviews to fetch**: how many of the newest reviews to bring in from **each** listing, from 1 to 1,000. It starts at 50. This setting appears only with the Business Profile option.

**6. Save**

Choose **Save**.

![The Google Reviews card with Review provider "Places API (New) — API key, up to 5 reviews": Setup guide — Places API key, Places API key saved as dots, Finding the Place ID.](https://mintcdn.com/fetchski-attract-api/MsE85fjBwOCKqNGh/images/cms/guides/connections/google-reviews/guides-connections-google-reviews-places-light.png?fit=max\&auto=format\&n=MsE85fjBwOCKqNGh\&q=85\&s=e4f40020ea763874504d17bafd980f2d)

The Places option needs a key and your listing's Place ID.

## What happens next

The first fetch starts within a minute of saving. After that, the card fetches again at the interval you chose. The badge reads **Connected**, with the time of the last fetch, or "Not synced yet." before the first one.

New reviews land in your **Google Reviews** list, ready for your sections. The sample reviews a new site comes with are removed after the first successful fetch. See [Google reviews](https://docs.fetchski-attract.com/guides/content/google-reviews.md).

**Next: put them on a page.** If no page has a Google Reviews section yet, add one. See [Google Reviews section](https://docs.fetchski-attract.com/guides/sections/google-reviews.md).

## Good to know

* **Check your minimum rating.** It starts at 5 stars, so 4-star reviews stay out until you lower it. Lower it, and lower-rated reviews come in from the next fetch.
* **Showing and keeping are separate.** Each Google Reviews section also has its own **Minimum rating to show**. Keep more here, and choose what each section shows there. See [Google Reviews section](https://docs.fetchski-attract.com/guides/sections/google-reviews.md).
* **Replies happen in the dashboard.** To answer a review, use **Reviews & replies** in the Google Business Dashboard. See [Google Business Profile](https://docs.fetchski-attract.com/guides/connections/google-business-profile.md).
* **You can stop at any time.** Set **Review provider** to **Off (no automatic sync)** to stop fetching. The reviews you already have stay.

## Troubleshooting

> [accordion] The badge says "Finish setting up
>
> The line under the badge says what's missing:
>
> * "Add the Places API key and your Place ID.": paste both, then save.
> * "Connect Google Business Profile first.": connect your listing on the **Google Business Profile** card, then come back.

> [accordion] No reviews arrive
>
> Check these in order:
>
> 1. **Enable scheduled sync** is on **Yes**. Without it, nothing is fetched.
> 2. **Minimum star rating to keep** isn't skipping the reviews you expect.
> 3. With the Business Profile option, each listing has **Manage this profile** on, on the **Google Business Profile** card.
> 4. Google may hold back reviews for a listing that isn't verified. Check **Verification** in the Google Business Dashboard.

> [accordion] I only get 5 reviews
>
> That's Google's limit for the **Places API (New) — API key, up to 5 reviews** option. To bring in every review, connect your [Google Business Profile](https://docs.fetchski-attract.com/guides/connections/google-business-profile.md) and switch **Review provider** to **Business Profile API — OAuth, all reviews**.

## Related

> [card] [Google Reviews section](https://docs.fetchski-attract.com/guides/sections/google-reviews.md)
>
> show reviews on a page.

> [card] [Google reviews](https://docs.fetchski-attract.com/guides/content/google-reviews.md)
>
> feature your favorites and add reviews by hand.

> [card] [Google Business Profile](https://docs.fetchski-attract.com/guides/connections/google-business-profile.md)
>
> connect your listing and reply to reviews.

> [card] [Connections](https://docs.fetchski-attract.com/guides/connections/index.md)
>
> every outside service your site uses.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.