> ## 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 Business Profile > Connect your Google listing once, then edit its details, reply to reviews, post updates and read its performance without leaving the CMS. Connect your Google Business Profile once, and you can run your listing from the CMS. Change your hours and details, reply to reviews, publish Google posts, add photos and see how people find you on Search and Maps. **Who can do this:** Admins and Owners. ## Before you start * **A Google account that manages your listing.** You approve the connection while signed in to it. * **About 30 minutes** in Google Cloud, Google's site for developer tools. The card's setup guide links every page you need. Your listing is your business's profile on Google Search and Maps: one listing per business location. The CMS also calls it a profile or a location. The Google account is separate: it's the sign-in you use to manage those listings. Three different approvals are involved: * **A verified listing.** Google must already have verified your listing, and it must have been active for at least 60 days. You do this on Google's site, before you start. * **Google's approval of your access request.** You ask Google, with a form, to let your project use its Business Profile tools. This is the step that makes you wait: approval isn't instant, so send the form first. * **Your permission when you sign in.** At the end, you sign in with Google and allow the CMS to manage your listings. This takes a minute. ## Connect your listing **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 Business Profile**. Its badge says **Not set up**. **2. Follow the setup guide** **Setup guide — Business Profile API** walks you through Google Cloud: * Create a project, or use one you have, and note its project number. * Turn on the Business Profile tools the guide lists. * Request access with Google's form, choosing **Application for Basic API Access**. Wait for Google's approval. * Create an OAuth client ID of the type **Web application**. Google gives you two values, a client ID and a client secret: together they're the login details for this connection. * Under **Authorized redirect URIs**, add your return address: where Google sends you back after you sign in. It's your site's address followed by `/api/v1/integration-settings/google-oauth/callback`. Copy that ending from the setup guide exactly. For example, `https://parkerspuppyplayland.example/api/v1/integration-settings/google-oauth/callback`. **3. Paste the client details** Copy Google's client ID into **OAuth client ID** and its client secret into **OAuth client secret**. **4. Save** Choose **Save**. The badge changes to **Finish setting up**, with the line "Press "Continue with Google" to connect your listing." ![The Google Business Profile card with the setup guide box, OAuth client ID filled with a sample value, OAuth client secret saved (dots, Saved and encrypted).](https://mintcdn.com/fetchski-attract-api/MsE85fjBwOCKqNGh/images/cms/guides/connections/google-business-profile/guides-connections-gbp-card-ready-light.png?fit=max\&auto=format\&n=MsE85fjBwOCKqNGh\&q=85\&s=6f3e049f08358d39901f323730c1602a) Save the client details, then choose Continue with Google. **5. Connect** Open **Connections** again, go to the card and choose **Continue with Google**. A new browser tab opens. Sign in with the Google account that manages your listing, and allow access. **6. Check the result** The tab shows **Google connected** and lists every listing that account can manage. Close the tab. **7. Reopen Connections** Back in the CMS, close Connections and open it again, so it shows your new listings. If you've changed anything since step 4, choose **Save** to close it; otherwise choose **Cancel**. **8. Choose your listings** Under **Connected profiles**, choose **Edit Connected profiles**. Turn on **Manage this profile** for each listing this site should manage. If there's only one, it's already on. Choose **Save** in the list window to keep the list. **9. Keep it up to date** Turn on **Enable scheduled profile sync**. The CMS then copies your listings from Google every 12 hours. To change that, open **Advanced options** → **Sync how often**. **10. Save** Choose **Save** to save everything. The badge reads **Connected**, with how many listings it manages and when it last synced. ![The Google Business Profile card after connecting: the Connected badge with "1 location · Last sync …".](https://mintcdn.com/fetchski-attract-api/tIdeo2aKESm5opj4/images/cms/guides/connections/google-business-profile/guides-connections-gbp-card-connected-light.png?fit=max\&auto=format\&n=tIdeo2aKESm5opj4\&q=85\&s=58b3a483ccbf419bc92d4ac57ac64a96) Connected: choose which listings this site manages. The same connection powers your Google reviews. To bring reviews onto your site, see [Google Reviews](https://docs.fetchski-attract.com/guides/connections/google-reviews.md). ## Open the Google Business Dashboard Open the command palette and choose **Google Business Dashboard**. The shortcut is T then B (press T, let go, then press B, while you're not typing in a box; see [Keyboard shortcuts](https://docs.fetchski-attract.com/guides/get-started/toolbar-and-command-palette.md#keyboard-shortcuts)). The first time, choose **Sync profiles now** to copy your listings in. The dashboard lists your listings on the left. Choose **All profiles** to see them all at once, or one listing to work on it. Below them are its sections: **Overview**, **Business info**, **Posts**, **Photos & media**, **Reviews & replies**, **Performance**, **Action links**, **People & access** and **Verification**. **Sync now** at the top fetches the latest from Google. ![The Google Business Dashboard on Overview for Parker's Puppy Playland: the listing on the left with its health badge, the section list.](https://mintcdn.com/fetchski-attract-api/tIdeo2aKESm5opj4/images/cms/guides/connections/google-business-profile/guides-connections-gbp-dashboard-overview-light.png?fit=max\&auto=format\&n=tIdeo2aKESm5opj4\&q=85\&s=4ceedec6c75e684b5e34c832f681046f) The Google Business Dashboard, with every section on the left. ## Change your listing's details Changes wait in the CMS until you send them to Google together. Two words on the buttons: to **stage** a change is to save it in the CMS, waiting; to **push** is to send the changes you pick to Google. Nothing reaches Google until you push. **1. Edit a card** In **Business info**, choose **Edit** on a card, such as **Regular hours** or **Description**. Make your change. **2. Stage it** Choose **Stage change**. The card shows **Edited**. Repeat for any other cards. **3. Review** Choose **Review & push** at the top. It lists every staged change, with what's **On Google** beside what you **Staged**. Uncheck anything you don't want to send yet. **4. Check it first (optional)** Choose **Validate with Google**. Google checks your business-info changes without saving them, and the result shows above the buttons. **5. Push** Choose **Push selected changes**. When it's done, you see a summary such as "2 pushed · 1 sent — in Google's review queue · 0 failed (stay staged)". ![The Review & push view with two staged changes for Parker's Puppy Playland (Regular hours and Description), each showing On Google and Staged values with its checkbox.](https://mintcdn.com/fetchski-attract-api/tIdeo2aKESm5opj4/images/cms/guides/connections/google-business-profile/guides-connections-gbp-review-push-light.png?fit=max\&auto=format\&n=tIdeo2aKESm5opj4\&q=85\&s=eccb8c56aba81ceeb9307860cd218f41) Review & push: see every staged change beside what's on Google, then push. Each card's badge tells you where things stand: * **Live**: matches Google. * **Edited**: you staged a change that isn't pushed yet. **Discard staged** throws it away. * **Pending at Google**: Google is reviewing a change before it goes live. * **Updated on Google**: Google, or someone on Google, changed it. Open **Compare with what's on Google now**, then choose **Use Google's version** or **Keep mine**. ## Reply to reviews **Reviews & replies** lists the reviews your [Google Reviews connection](https://docs.fetchski-attract.com/guides/connections/google-reviews.md) has fetched. Set its **Review provider** to **Business Profile API — OAuth, all reviews** and **Enable scheduled sync** to **Yes**. It keeps only 5-star reviews at first. To reply to lower ratings, lower its **Minimum star rating to keep**. In **Reviews & replies**, filter by **All**, **Unanswered** or **Staged**. Choose **Reply** on a review, write your answer and choose **Stage reply**. Replies go out with **Review & push**, like other changes. Google checks every reply before it shows publicly. Until then the reply says **Sent — in Google's review queue**. If Google refuses one, it shows **Rejected by Google**, with Google's reason when it gives one. To choose which reviews show on your site, choose **Open the Reviews manager**. ## Post updates, events and offers In **Posts**, choose **New post**. Pick the **Post type**, write the **Summary**, and add a photo or a **Button** if you like. Then choose **Publish to Google**. Posts don't wait for **Review & push**. They go to Google right away. Google may still review a post first. Its badge shows **Live**, **In Google's review queue** or **Rejected by Google**. ## Photos In **Photos & media**, **Your photos** shows your listing's photos and **From customers** shows your customers' photos. To add one, choose **Add a photo** and pick it from your media library. Then choose its **Category** and choose **Stage upload**. You can also **Change category** or **Remove** your own photos. Photos go to Google with **Review & push**. Google fetches each photo from your site, so your site must be public. Customers' photos are read-only here. To report one, use Google's own Business Profile tools. ## Performance, action links and more * **Performance**: how many people saw your listing on Search and Maps, and how many called, visited your website or asked for directions. Switch between **30 days**, **90 days** and **12 months**. **Update data** fetches the latest. Google's most recent days can take a while to fill in. * **Action links**: the booking or ordering buttons Google shows on your listing. Choose **Add link** to add one. Google decides which kinds your listing can have, based on its categories. * **People & access**: who can manage your listing on Google. To change it, choose **Manage in Google Business Profile ↗**. * **Verification**: your listing's verification status, and what Google asks you to do next. You verify on Google's site. ## The Google Business Profile lists Three lists, named GBP for Google Business Profile, in the command palette show what the CMS has copied from Google: * **GBP Locations**: your listings. Choose **Go to GBP Locations** (G then Shift+B: hold Shift for the B) * **GBP Posts**: choose **Go to GBP Posts** (G then Shift+P) * **GBP Media Items**: choose **Go to GBP Media Items** (G then Shift+M) These lists are for looking things up. You make changes in the dashboard, and each list has **Open Dashboard** to take you there. **GBP Locations** also has **Sync now**. ## What happens next Staged changes stay in the CMS until you push them. After a push, Google may hold a change in its own review before it goes live. Posts are the exception: they're sent the moment you publish them. With scheduled sync on, the CMS fetches each listing from Google on its own. It also fetches performance data once a day. > [!WARNING] > > **Google's limits.** Google accepts 100 new posts and photo uploads a day for your site, shared between them. Extra uploads stay staged: push them again the next day. Google also allows only 10 edits a minute per listing, so a big push takes a few minutes. ## Troubleshooting > [accordion] Not ready to connect > > The new tab says: > > "Enter the OAuth client ID and client secret in the vault, SAVE, then click Continue with Google again." > > Paste both into the card, choose **Save**, then choose **Continue with Google** again. > [accordion] Connect link expired > > You took more than 10 minutes, or used an old tab. Go back to the card and choose **Continue with Google** again. > [accordion] Google declined the connection" or "Connection failed > > Google didn't allow access. Check that the redirect address in your OAuth client matches the setup guide exactly, and that you signed in with the account that manages your listing. Then try again. > [accordion] Google connected" mentions "quota exceeded > > The connection is saved, but Google hasn't approved your access request yet. Wait for Google's approval email, then choose **Sync profiles now** in the dashboard. > [accordion] The dashboard says "Connect Google Business Profile first" or "Choose the profiles to manage > > The connection isn't finished, or no listing has **Manage this profile** on. Choose **Open Connections** and finish the steps above. > [accordion] Performance shows no data, or Google refuses a post > > Google holds back some features until a listing is verified. Check **Verification** in the dashboard, and finish verifying on Google's site. ## Related > [card] [Google Reviews](https://docs.fetchski-attract.com/guides/connections/google-reviews.md) > > show your Google reviews on your site. > [card] [Google reviews](https://docs.fetchski-attract.com/guides/content/google-reviews.md) > > the reviews your site shows; feature your favorites. > [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.