Connect Mage Loyalty to your Gorgias helpdesk to give your support agents instant access to customer loyalty data.
What does the integration do?
The Mage Loyalty integration for Gorgias adds a sidebar widget to your tickets and syncs loyalty data to your customer profiles. This means your agents can:
See a customer's points balance, VIP tier, and recent loyalty activity without leaving Gorgias
Use template variables in macros to personalise replies with live loyalty data
Data syncs automatically every time a ticket is created or a new message is received, so agents always see up-to-date information.
How to connect Mage Loyalty with Gorgias
Before you start, make sure you have:
Admin access to your Gorgias account
Mage Loyalty installed on your Shopify store
Step 1: In your Shopify admin, open the Mage Loyalty app and go to Integrations.
Step 2: Click on the Gorgias integration card.
Step 3: Enter your Gorgias subdomain. This is the part before .gorgias.com in your Gorgias URL. For example, if you log in at acme.gorgias.com, enter acme.
Step 4: Click Connect with Gorgias. You'll be redirected to Gorgias to authorise the connection.
Step 5: Sign in to Gorgias if prompted, then review the requested permissions and click Allow.
Step 6: You'll be redirected back to Mage with a confirmation message. The sidebar widget is set up automatically — no further configuration is needed in Gorgias.
Step 7: To verify, open a ticket in Gorgias for a customer enrolled in your loyalty program. You should see the Mage Loyalty card in the right-hand sidebar.
What customer data is synced to the Gorgias sidebar?
When an agent opens a ticket, the Mage Loyalty sidebar widget displays the following data for that customer:
Data | Description |
Points Balance | Current spendable points |
Lifetime Points | Total points earned all-time |
Redeemed Points | Total points spent on rewards |
VIP Tier | Current tier (e.g. Gold, Platinum) |
Next Tier | The tier they're working towards |
Points to Next Tier | How many more points they need to level up |
Referral URL | Customer's unique referral link |
Member Since | Date they joined the loyalty program |
Recent Activity | Last 5 loyalty events (points earned, rewards redeemed, etc.) |
If a customer is not enrolled in your loyalty program, the sidebar will display default values (0 points, "Not enrolled").
The customer's email address in Gorgias must match their email in your loyalty program for the data to link correctly.
What template variables are available?
Template variables let you insert live loyalty data into your Gorgias macros and pre-made responses. When an agent applies a macro to a ticket, Gorgias replaces each variable with the customer's actual data — making replies feel personal without any manual lookup.
Variable | What it shows | Example output |
| Current spendable points | 2,500 |
| Total points earned all-time | 5,000 |
| Total points spent on rewards | 2,500 |
| Current VIP tier name | Gold |
| Next tier they can reach | Platinum |
| Points needed to reach the next tier | 500 |
| Customer's unique referral link | |
| Date they joined the loyalty program | 2024-06-15 |
How to use them:
In Gorgias, go to Settings > Macros
Create a new macro or edit an existing one
Paste any of the variables above into your response text where you want the data to appear
Save the macro
Example macro:
Hi {{ticket.customer.firstname}}, you currently have {{ticket.customer.data.mage_points_balance}} points available to redeem. As a {{ticket.customer.data.mage_vip_tier}} member, you're only {{ticket.customer.data.mage_points_to_next_tier}} points away from reaching {{ticket.customer.data.mage_next_vip_tier}}!
Note: Template variables are populated after the first ticket interaction for a customer. If the customer has never had a ticket before, the variables may be empty until a ticket is created or a message is received.
How to disconnect
In your Shopify admin, open Mage Loyalty and go to Integrations
Click on the Gorgias integration
Click Disconnect
Confirm the action
This will remove the Mage Loyalty sidebar widget from your Gorgias account and revoke the connection. You can reconnect at any time by following the setup steps above.