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

# Google My Business

> How to add Google My Business to your system

<img src="https://mintcdn.com/forceplay/LL5FipRv-7nhg1To/images/channels/google-business.svg?fit=max&auto=format&n=LL5FipRv-7nhg1To&q=85&s=72c001245575c7c7705243680c356f53" alt="Google My Business" height="44" noZoom style={{ height: "44px", marginBottom: "1.25rem" }} data-path="images/channels/google-business.svg" />

<Snippet file="never-share.mdx" />

## What she can post to Google My Business

A news update on the profile, an event with dates attached, an offer carrying a coupon code. All three land on your Business Profile with a button underneath, and you pick which button it is.

<CardGroup cols={2}>
  <Card title="Character limit" icon="text-width">
    1,500 characters
  </Card>

  <Card title="Media" icon="photo-film">
    Optional. One image, no video
  </Card>

  <Card title="Post types" icon="layer-group">
    Update, event, offer
  </Card>

  <Card title="Analytics" icon="chart-line">
    Yes, for the location. Nothing per post
  </Card>
</CardGroup>

Location numbers come back as website clicks, phone calls and direction requests, with map views split between desktop and mobile. Per post there is nothing to show: the Business Profile Performance API reports on the location rather than the individual update, so a Google My Business post opens an empty chart by design.

|                   |                                                                                                                                                                            |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Post settings** | `topicType`, `callToActionType`, `callToActionUrl`, plus the event and offer fields. Full schema in the [Google My Business settings reference](/public-api/providers/gmb) |
| **Connect flow**  | Two steps. You authorize the Google app, then pick which business location to attach. Every location under every account you manage is listed                              |
| **Automations**   | None                                                                                                                                                                       |

<Warning>
  Google turns some posts back before she calls the API:

  * **Google My Business posts can only have one image.**
  * **Google My Business posts do not support video attachments.**
  * **Event posts require an event title.**

  A call to action button takes one of `BOOK`, `ORDER`, `SHOP`, `LEARN_MORE`, `SIGN_UP`, `GET_OFFER` or `CALL`, plus `NONE` for an update that carries no button at all. The type and the URL travel as a pair: the button only reaches Google when a type other than `NONE` and a valid URL are both set.
</Warning>

## Self-hosting

<Info>
  On PostQueen Cloud this channel is ready: open **Add Channel** and pick it.
  Running your own instance? You register the application yourself:
  [Set up Google My Business on your own instance](/installation/providers/google-my-business).
</Info>

## Troubleshooting

### Business Profile Not Showing

Ensure your Google Business Profile is verified and that you are logging in with the Google account that owns or manages the business profile.

### Analytics returns empty or filter errors

The GMB performance API restricts which metric combinations and date ranges it will return data for. If PostQueen shows an empty analytics chart, double-check the date range you have selected covers periods after the profile was verified. Some metrics are not available for newer or unverified profiles at all: the API returns no data rather than an error.

### Known issue: connect page surfaces session-recording errors

The `/integrations/social/gmb` page can surface session-replay overlay errors that mask the actual OAuth flow. The handshake usually still completes. Refresh the Channels page after authorizing on Google's side. Tracked in [Known Issues](/troubleshooting/known-issues).

<Snippet file="next-steps-provider.mdx" />