Skip to main content
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. 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).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).

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 …".The Google Business Profile card after connecting: the Connected badge with "1 location · Last sync …".

Connected: choose which listings this site manages.

The same connection powers your Google reviews. To bring reviews onto your site, see Google Reviews.

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). 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.The Google Business Dashboard on Overview for Parker's Puppy Playland: the listing on the left with its health badge, the section list.

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.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.

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 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: 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.
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

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.
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.
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.
The connection isn’t finished, or no listing has Manage this profile on. Choose Open Connections and finish the steps above.
Google holds back some features until a listing is verified. Check Verification in the dashboard, and finish verifying on Google’s site.

Google Reviews

show your Google reviews on your site.

Google reviews

the reviews your site shows; feature your favorites.

Connections

every outside service your site uses.