Documentation Index
Fetch the complete documentation index at: https://docs.mention-me.com/llms.txt
Use this file to discover all available pages before exploring further.
This guide covers manual Mention Me tag implementation for Shopify stores that are not using the Mention Me Shopify App. If you have the Shopify App installed, see the installation guide instead.
Referee Tag
The Referee Tag displays a “Been referred by a friend?” link, enabling customers to identify who referred them.
The Referee experience can also be added to your Shopify Checkout using the
Checkout Extensibility App. This manual approach is for adding the tag to Cart, Basket, or Side Cart pages.
Cart / Basket Page
Add a <div> where the link should appear, then add the JavaScript snippet after it.
Locate and edit your cart template (e.g., cart.liquid).
Add the Div
<div id="mmWrappercart"></div>
Add the Script
<script>
var partnerCode = "INSERT_PARTNERCODE";
var situation = "cart";
var urlComponents = ["https://tag.mention-me.com/api/v2/refereefind/", partnerCode];
var queryComponents = [
["situation", situation],
["locale", Shopify.locale + "_" + Shopify.country]
];
queryComponents = queryComponents.map(qc => qc[0] + "=" + encodeURIComponent(qc[1]));
var url = urlComponents.join("") + "?" + queryComponents.join("&");
var script = document.createElement("script");
script.src = url;
document.getElementsByTagName("head")[0].appendChild(script);
</script>
INSERT_PARTNERCODE with your actual Mention Me PartnerCode. For locale configuration, see Shopify: Locales.
Sidecart / Popout Cart
If using a slide-out or pop-up cart (e.g., sidecart.liquid):
<script>
var partnerCode = "INSERT_PARTNERCODE";
var situation = 'sidecart';
var implementation = 'link';
if (window.MentionMeFiredTags && window.MentionMeFiredTags[implementation + situation]) {
delete window.MentionMeFiredTags[implementation + situation];
}
var urlComponents = ["https://tag.mention-me.com/api/v2/refereefind/", partnerCode];
var queryComponents = [
["situation", situation],
["locale", Shopify.locale + "_" + Shopify.country]
];
queryComponents = queryComponents.map(qc => qc[0] + "=" + encodeURIComponent(qc[1]));
var url = urlComponents.join("") + "?" + queryComponents.join("&");
var script = document.createElement("script");
script.src = url;
document.getElementsByTagName("head")[0].appendChild(script);
</script>
Checkout (Shopify Plus only)
Shopify Plus merchants can modify checkout.liquid:
<script>
var partnerCode = "INSERT_PARTNERCODE";
var situation = "checkout";
var urlComponents = ["https://tag.mention-me.com/api/v2/refereefind/", partnerCode];
var queryComponents = [
["situation", situation],
["locale", Shopify.locale + "_" + Shopify.country]
];
queryComponents = queryComponents.map(qc => qc[0] + "=" + encodeURIComponent(qc[1]));
var url = urlComponents.join("") + "?" + queryComponents.join("&");
var script = document.createElement("script");
script.src = url;
document.getElementsByTagName("head")[0].appendChild(script);
</script>
checkout.liquid? Review the checkout extensibility guide.
Landing Page
A landing page lets customers engage with your referral program without requiring a purchase.
Creating a Landing Page
Create a new page
Log in to your Shopify admin, navigate to Pages, and create a new page (e.g., Referral Landing Page). You may set it as Hidden initially.
Add the referral code
Open the code editor and paste the following in HTML mode:
<div id="mmWrapper"></div>
<script>
var partnerCode = "INSERT_PARTNERCODE";
var urlComponents = [
"https://tag.mention-me.com/api/v2/referreroffer/",
partnerCode
];
var queryComponents = [
["situation", "landingpage"],
["locale", Shopify.locale + "_" + Shopify.country]
];
queryComponents = queryComponents.map(qc => qc[0] + "=" + encodeURIComponent(qc[1]));
var url = urlComponents.join("") + "?" + queryComponents.join("&");
var script = document.createElement("script");
script.src = url;
document.getElementsByTagName("head")[0].appendChild(script);
</script>
INSERT_PARTNERCODE with your actual partner code. For locale configuration, see Shopify: Locales.
Dashboard Tag
The referral dashboard allows customers to view referral activity, track rewards, and share offers from their account.
Setup Steps
Create a Page
Navigate to Online Store > Pages > Add Page, title it “Referral Dashboard”.
Create a Page Template
Navigate to Online Store > Themes > Edit code. Under Templates, create page.refer.liquid.
Add the Template Code
{% if customer %}
<div style="width: 100vw; margin-left: calc(-50vw + 50%);">
<h2 style="text-align: center;">Hi {{ customer.first_name }}, refer your friends and earn!</h2>
<div id="mmWrapper"></div>
</div>
<script type="text/javascript">
var partnerCode = "PARTNERCODE";
var email = {% if customer %}"{{ customer.email }}"{% else %}null{% endif %};
var firstname = {% if customer %}"{{ customer.first_name }}"{% else %}null{% endif %};
var surname = {% if customer %}"{{ customer.last_name }}"{% else %}null{% endif %};
var locale = "{{ localization.language.iso_code | upcase }}";
var country = {% if customer and customer.default_address %}
"{{ customer.default_address.country_code }}"
{% else %}
"{{ localization.country.iso_code }}"
{% endif %};
var params = [
["situation", "dashboard"],
["implementation", "embed"],
["email", email],
["firstname", firstname],
["surname", surname],
["locale", locale + "_" + country]
];
var query = params.map(p => p[0] + "=" + encodeURIComponent(p[1])).join("&");
var script = document.createElement("script");
script.src = "https://tag.mention-me.com/api/v2/dashboard/" + partnerCode + "?" + query;
document.head.appendChild(script);
</script>
{% else %}
<div>
<p>You need to log in or create an account to access the referral dashboard.</p>
<p><a href="/account/login">Log in</a></p>
</div>
{% endif %}
Assign the Template
Go to the page, under “Theme Template” select refer, click Save.
Test
Visit /account/login, log in as a test customer, then go to /pages/referral-dashboard.
Promoting the Page
- Add the page to your website navigation menu
- Include a “Refer a friend and earn” CTA in transactional emails linking to this page
For additional customer attributes, see: Shopify Liquid Customer Object
Coupon Code Integration (Legacy)
This feature requires a version of Legacy App creation in Shopify that was deprecated in January 2026. Use this as a reference for existing integrations only.
Set Up Your Discounts
Create a new discount
Go to the Shopify Discounts section and create a new discount.
Select discount type
Select “Amount off order” as the discount type (“Buy X, Get Y” is not supported).
Choose Discount Code
Choose “Discount Code” as the method.
Configure discount value
Set the discount value (Percentage or Fixed Amount).
Set usage limits
Set Maximum Discount Uses: Limit to 1 total use and Limit to one use per customer.
Save and repeat
Save, then repeat for each reward type.
Creating a Shopify Private App
Open app development
Go to Settings > Apps and sales channels, click Develop apps and accept the prompt.
Create the app
Click Create an app, name it (e.g., “Mention Me Discount Codes”).
Configure API scopes
Go to Configuration > Configure Admin API scopes. Search for “discount” and set Discounts and Price rules to read and write.
Install and copy token
Go to API credentials, click Install app. Reveal and copy the API token (only visible once).
Select Shopify
Select Shopify from the list.
Enter credentials
Enter your Shopify Store Name (subdomain) and the Admin API token.
Link the integration
Contact your Mention Me onboarding or client success manager to link the integration to your rewards setup.
