> 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/paper/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.