> For the complete documentation index, see [llms.txt](https://docs.roadmap.so/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roadmap.so/loyalty-and-rewards/loyalty-integrations/set-up-roadmap-loyalty-in-shopify-pos.md).

# Set up Roadmap loyalty in Shopify POS

Add the Redeem loyalty points and Loyalty point adjustments tiles to Shopify POS from Shopify admin or directly on the POS device.

Use this guide to add Roadmap loyalty to Shopify POS.

This setup gives staff two loyalty tiles:

* **Redeem loyalty points**
* **Loyalty point adjustments**

The adjustments tile is your pending points log in POS.

### Before you start

Make sure these are already true:

* your loyalty program is active
* staff can access the Shopify POS device
* **Fulfilled Order Adjustments** is set to **Require approval before adjusting** if you want to use the adjustments tile

{% hint style="info" %}
Changes made in **Point of Sale → Settings → POS apps** apply to all POS devices across all locations.
{% endhint %}

### Option 1: Add the tiles from Shopify admin

{% stepper %}
{% step %}

#### Open Shopify POS settings

In Shopify admin, go to **Point of Sale**.

Then open **Settings**.
{% endstep %}

{% step %}

#### Open POS apps

In **Settings**, select **POS apps**.

Choose **Roadmap** from the app list.
{% endstep %}

{% step %}

#### Add the loyalty extensions

Open **App extensions**.

Add these two Roadmap extensions:

* **POS UI extension** — this becomes the **Redeem loyalty points** tile
* **Loyalty Points Adjustments** — this becomes the **Loyalty point adjustments** tile

If the redemption extension appears as **POS UI extension**, that is expected.

<figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FCJWDq6dSt6rr6iXxMqRQ%2FScreenshot%202026-05-06%20at%202.06.13%E2%80%AFPM.png?alt=media&amp;token=427cc4ae-8ff2-4060-9435-6dc870b7c387" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Refresh Shopify POS

Close and reopen Shopify POS on the device.

Then confirm both tiles appear on the smart grid.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
After setup, Shopify POS can show one Roadmap entry as **Roadmap** and the other as **Loyalty Points Adjustments**. That is expected.
{% endhint %}

### Option 2: Add the tiles on the POS device

{% stepper %}
{% step %}

#### Open the smart grid

On the POS home screen, tap **Add tile**.
{% endstep %}

{% step %}

#### Choose an app tile

Tap **App**.

Then select **Roadmap**.

<div align="left"><figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FYE4ddHBHGn4KyRbIZahn%2FIMG_2732.PNG?alt=media&amp;token=795804a4-7ff2-48fe-b63e-43b3189a4338" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Add the loyalty extensions

Add these two options:

* **POS UI extension** — this becomes **Redeem loyalty points**
* **Loyalty Points Adjustments** — this becomes **Loyalty point adjustments**

Repeat the same flow if you only add one tile first.
{% endstep %}

{% step %}

#### Confirm the tiles are visible

Return to the smart grid.

Check that both loyalty tiles now show on the POS home screen.

<div align="left"><figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FG3ahpXSCyp9eH6P7FpKl%2FIMG_2726.PNG?alt=media&amp;token=b6d14468-4882-4af1-95be-39f356513a2d" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### What each tile does

#### Redeem loyalty points

Use this tile when a customer is attached to the cart and wants to use their points.

Staff can:

* view the customer's available points
* redeem an available reward
* apply an existing loyalty discount if one already exists

<div><figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FcaejsYbUgLl5Ot1Q3e4W%2FIMG_2727.PNG?alt=media&amp;token=6e9acdd8-8185-4016-b897-faac07364c7f" alt=""><figcaption></figcaption></figure> <figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FeozHRtHIE6lZahZpKDpD%2FIMG_2728.PNG?alt=media&amp;token=e8fd413d-ba96-4268-944c-e938e72ccbde" alt=""><figcaption></figcaption></figure> <figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FttOnoQxSFlt1HeYjlh9r%2FIMG_2729.PNG?alt=media&amp;token=ad97b7d1-5a30-4be0-9395-012709d86c22" alt=""><figcaption></figcaption></figure></div>

#### Loyalty point adjustments

Use this tile to review pending point changes created after a fulfilled order changes.

Staff can:

* open the pending adjustment list
* review the suggested points change
* approve or reject the adjustment

This is useful for POS refunds, returns, exchanges, and other post-fulfilment edits.

<div align="left"><figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2F8gn4KkUPOu8xupnsg0Zf%2FIMG_2724.PNG?alt=media&amp;token=bc88bdbd-0952-44af-95f3-d55693d82c0b" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="https://393112916-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ8asLD4FVCFagK40xEr4%2Fuploads%2FfgkEWSPQxvKvrUy6p92i%2FIMG_2725.PNG?alt=media&amp;token=5850e115-ac5d-47a9-8ef9-c701d35ed8a8" alt="" width="375"><figcaption></figcaption></figure></div>

### Test the setup

After adding the tiles, run a quick test:

1. Attach a loyalty customer to the cart.
2. Open **Redeem loyalty points** and confirm rewards appear.
3. If you use pending adjustments, open **Loyalty point adjustments** and confirm pending items appear when expected.

{% hint style="warning" %}
If the tiles do not appear, close and reopen Shopify POS first.

If they still do not appear, check that both Roadmap app extensions were added.
{% endhint %}

### Related guides

* [How to configure your point settings](/loyalty-and-rewards/getting-started/how-to-configure-your-point-settings.md)
* [Managing point adjustments post-fulfilment](/loyalty-and-rewards/points-and-ways-to-earn/managing-point-adjustments-post-fulfilment.md)
* [Loyalty membership eligibility settings](/loyalty-and-rewards/getting-started/loyalty-membership-eligibility-settings.md)


---

# 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://docs.roadmap.so/loyalty-and-rewards/loyalty-integrations/set-up-roadmap-loyalty-in-shopify-pos.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.