# Joy and Air Reviews

{% hint style="info" %}
Who can use this feature?

This feature is available for **Essential, Advanced and Ultimate** plans.
{% endhint %}

In this article, we will guide you on how to make the integration between Joy and Air Review to allow customers to earn points for feedback on your products.

Make sure that you have both apps installed on your Shopify store:

* Air Reviews: <https://apps.shopify.com/air-reviews>
* Joy: <https://apps.shopify.com/joyio>[​](https://help.avada.app/joy/integrate-joy-with-air-reviews/#how-to-get-app-id-and-secret-key-from-air-review)

### Get authentication keys from Air Reviews and connect with Joy[​](https://help.avada.app/joy/integrate-joy-with-air-reviews/#how-to-integrate-joy-with-air-reviews)

{% stepper %}
{% step %}
Go to **`Air Reviews`**` ``>`` `**`Settings`**` ``>`` `**`Manage keys`** to find your pair: **App ID** and **Secret key**
{% endstep %}

{% step %}
Get back to the **Joy app** and go to the **`Integrations > Air Reviews`** page

<figure><img src="/files/LIRSiZAxvOsGr6BlIXQK" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Store Air Reviews pair of keys in Joy and test the program

{% stepper %}
{% step %}
**Store Air Reviews pair of keys in Joy**

Go to the **Rewards programs** page, and create the **Write review program**

You will see the option for Air Reviews shown as `Connected`

<figure><img src="/files/xd2X1zwW1PTqYKiDV249" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Test the program**

Visit the `Activities > Review activities > View all reviews activities`

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

Customers won't see their balance updated until the reward is approved, preventing abuse of points through reviews

<figure><img src="/files/TcQGz5h9PFv1QNT5FR0h" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Show customer reviews in the Unified Widget

Once Joy and Air Reviews are connected, you can surface a **Reviews** tab directly inside the Unified Widget — so customers view the reviews they've written and submit new ones without leaving the loyalty widget. Joy renders the entire experience in your brand styling; review data is served by Air Reviews behind the scenes.

What customers see in the tab:

* Each review with its date, product (and thumbnail), star rating, review text, status (**Published** or **Pending**), and points earned
* A **Write a review** action that opens an inline form inside the widget — no redirect
* An empty state prompting first-time reviewers to write a review and earn points

### How to add the Reviews tab

{% stepper %}
{% step %}

### Connect Air Reviews first

Complete the integration steps above so Air Reviews shows as **Connected** in Joy.
{% endstep %}

{% step %}

### Open the Unified Widget

Go to **On-site content → Widget → Unified Widget**.
{% endstep %}

{% step %}

### Turn on the Reviews extension

In the **Extensions** section, turn on the **Reviews** toggle. Once enabled, **Reviews** appears automatically in the **Footer menu** list — no manual add needed.
{% endstep %}

{% step %}

### Edit the label and star rating

In the **Footer menu**, open the Reviews item to edit its **label** and **star rating** display so they match your brand.
{% endstep %}

{% step %}

### Save and publish

Save your changes. The Reviews tab appears in the live widget for logged-in customers.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Reviews appear after a customer is identified (logged in). Points show once Air Reviews approves the review — pending reviews display without points until approval. This works alongside the existing [Write review earning program](/reward-programs/earning-programs/write-review.md).
{% endhint %}


---

# Agent Instructions: 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.joy.so/integrations/product-reviews/air-reviews.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.