> For the complete documentation index, see [llms.txt](https://reputon.gitbook.io/reputon-help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://reputon.gitbook.io/reputon-help/facebook-reviews-app/how-to/add-your-facebook-reviews.md).

# Add your Facebook reviews

{% hint style="success" %}
**Before you start:** Make sure your Facebook Page has the Reviews (Recommendations) section enabled and set to public. If it's turned off, the widget will have nothing to import.
{% endhint %}

{% embed url="<https://www.youtube.com/watch?v=6x_pAsbwJvU>" %}

### Setup: 4 steps

1. **Connect your Facebook account**

   Click **Connect Facebook**. You'll be redirected to Facebook to grant the app permission to read your Page's reviews.

<figure><img src="/files/3inGDh6pSf4ijgeW5yWC" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/RxYSSk79CORQFTIYIGVv" alt=""><figcaption></figcaption></figure>

2. **Select your Facebook Page**\
   After authorization, a dropdown will show all Pages associated with your Facebook account. Select the Business Page whose reviews you want to display.

{% hint style="info" %}
Only **Business Pages** appear in the list. Personal profiles and Facebook Marketplace are not supported.
{% endhint %}

<figure><img src="/files/1MwphUrpEX2MjK2C3aTX" alt=""><figcaption></figcaption></figure>

3. **Choose a widget type**\
   In the "Display reviews" tab, select the layout that fits your store best. You can always change it later.

<figure><img src="/files/WjUeF7Nl7LpZr82X5tiK" alt=""><figcaption></figcaption></figure>

4. **Add the widget to your store page**\
   Click **Add widget**. The Shopify theme editor will open. Use the section picker to place the widget wherever you want.

{% hint style="success" %}
**Tip:** The homepage hero area and product pages are the highest-converting placements. Shoppers look for social proof right before making a purchase decision.
{% endhint %}

5. **Save and preview**\
   Click **Save** in the theme editor. Open your store to see the widget live.

### Widget showing fewer reviews?

1. **Some reviews are set to private**

   Facebook users can restrict visibility of their own activity. Reviews set to "Friends only" or "Only me" won't appear publicly, even if you can see them as the Page admin. This is a Facebook privacy setting and cannot be overridden by the app.
2. **Widget limit is set to fewer than your total reviews**

   Each widget displays up to **20 reviews** by default. If you have more, the widget shows the most recent ones.
3. **New reviews haven't synced yet**

   The app syncs every 24 hours. A review left today may not appear until tomorrow. To force an immediate refresh, go to `Widget Settings → Refresh reviews`.
4. **Reviews tab is disabled on your Facebook Page**

   If the Reviews/Recommendations section is turned off on your Page, the app has nothing to import. Go to **Facebook Page Settings → Templates and Tabs → Reviews** and enable it.&#x20;

***

{% hint style="info" icon="comments-question-check" %}
**Have questions or need help with the widget? Contact us at** [**support@reputon.com**](mailto:support@reputon.com) **or** [**live chat**](https://go.crisp.chat/chat/embed/?website_id=d24ef16e-6e05-49e9-bd59-a6f3bde0658a)
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://reputon.gitbook.io/reputon-help/facebook-reviews-app/how-to/add-your-facebook-reviews.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.