> For the complete documentation index, see [llms.txt](https://help.brickspacelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.brickspacelab.com/keystone/advanced-customizations/installing-a-review-app.md).

# Install a review app

{% hint style="warning" %}
**We do not provide support for code customizations**

If you are not comfortable making code changes, we highly recommend [hiring an expert developer](broken://pages/Fyss7M7PkIKyON7bVWSI).
{% endhint %}

{% hint style="info" %}
Most apps support app-block install for reviews widgets.
{% endhint %}

To display ratings and reviews properly in our Shopify themes, a standard metafield is used. If your review app doesn't use this metafield, you'll need to edit the code to integrate review widgets throughout

## Changing review and rating metafields

{% stepper %}
{% step %}
**Find correct metafields**

* Identify the metafields used by your review app - you may have to look through app documentation or contact support.
  {% endstep %}

{% step %}
**Edit code**

* Open up `component__rating.liquid`
* If you can't find a metafield from your app that points to the max value then you can manually set this. E.g. if your rating system goes from 0-5 you would set max to 5.
* Update lines 29-31 to point to your app metafields. After making changes it should look something like this. The below example uses metafields from Loox.

{% code title="component\_\_rating.liquid" %}

```liquid
{% assign rating = product.metafields.loox.avg_rating | times: 1 %}
{% assign rating_count = product.metafields.loox.num_reviews  %}
{% assign max = 5 %}
```

{% endcode %}
{% endstep %}
{% endstepper %}


---

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

```
GET https://help.brickspacelab.com/keystone/advanced-customizations/installing-a-review-app.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
