> ## 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.

# Migrating to the New Shopify App

> How to install and configure the new Mention Me Shopify App and safely transition from the old app.

This guide covers installing the new Mention Me Shopify App, setting up Product and Brand Referral, verifying settings, adding app extensions, and safely transitioning from the old app.

## Introduction

The new Mention Me Shopify App is available on the marketplace, centralising all Mention Me products in one app with a public install link. Visit [the Mention Me Shopify App page](https://apps.shopify.com/mention-me) to get started for free.

## Installing the App

Visit [the Mention Me Shopify App page](https://apps.shopify.com/mention-me) and click **Install**.

<img src="https://mintcdn.com/mentionme/GjiDi6ZwHP27Pu0w/images/knowledge/shopify/33701698687773.png?fit=max&auto=format&n=GjiDi6ZwHP27Pu0w&q=85&s=dd2728685d49ca4180a57881100058a3" alt="Mention Me Shopify App install page" width="1366" height="960" data-path="images/knowledge/shopify/33701698687773.png" />

To learn more about why we need this data, visit our [Privacy Policy](https://mention-me.com/help/plg/privacy_policy).

## Configuring Brand Referral

<Steps>
  <Step title="Open Brand Referral settings">
    Open Brand Referral settings in the newly installed Mention Me app.

    <img src="https://mintcdn.com/mentionme/GjiDi6ZwHP27Pu0w/images/knowledge/shopify/33701706994205.png?fit=max&auto=format&n=GjiDi6ZwHP27Pu0w&q=85&s=9c6d426c6dfab3412360efb2b726baa2" alt="Brand Referral settings in new Mention Me app" width="3696" height="2094" data-path="images/knowledge/shopify/33701706994205.png" />
  </Step>

  <Step title="Verify settings match the old app">
    Go to the old app through the Shopify Apps menu.

    <img src="https://mintcdn.com/mentionme/GjiDi6ZwHP27Pu0w/images/knowledge/shopify/33701706994589.png?fit=max&auto=format&n=GjiDi6ZwHP27Pu0w&q=85&s=de848c013c74b06958abb331b0e75aa5" alt="Shopify Apps menu showing old Mention Me app" width="2582" height="1220" data-path="images/knowledge/shopify/33701706994589.png" />

    Select the app that starts with "Mention Me" and includes your Store name.
  </Step>

  <Step title="Compare all settings">
    Check that all settings on the old app match the new app.

    <img src="https://mintcdn.com/mentionme/GjiDi6ZwHP27Pu0w/images/knowledge/shopify/33701706994845.png?fit=max&auto=format&n=GjiDi6ZwHP27Pu0w&q=85&s=69c66f4667aa491ac730a36009fd9278" alt="Old Mention Me app settings for comparison" width="3214" height="1900" data-path="images/knowledge/shopify/33701706994845.png" />

    <img src="https://mintcdn.com/mentionme/GjiDi6ZwHP27Pu0w/images/knowledge/shopify/33701698689181.png?fit=max&auto=format&n=GjiDi6ZwHP27Pu0w&q=85&s=69060bb1ff7ac7c66e6978ea7bd3132e" alt="New Mention Me app settings to verify match" width="3696" height="2094" data-path="images/knowledge/shopify/33701698689181.png" />
  </Step>
</Steps>

## Adding the Extensions

Follow the steps in [Shopify App: Installation](/knowledge/shopify/app-installation) to add all the blocks you had with the previous Mention Me app and verify the same settings.

### Example: Mention Me Checkout Journey

After going to the Checkout Editor:

<Steps>
  <Step title="Click Add Block">
    <img src="https://mintcdn.com/mentionme/GjiDi6ZwHP27Pu0w/images/knowledge/shopify/33701698694045.png?fit=max&auto=format&n=GjiDi6ZwHP27Pu0w&q=85&s=3501b74222683472f228903f1d00a12d" alt="Checkout editor Add Block button" width="1434" height="796" data-path="images/knowledge/shopify/33701698694045.png" />
  </Step>

  <Step title="Select the new Widget">
    Select the Widget from the App without your brand name. You will now have two blocks on the page.

    <img src="https://mintcdn.com/mentionme/GjiDi6ZwHP27Pu0w/images/knowledge/shopify/33701698694429.png?fit=max&auto=format&n=GjiDi6ZwHP27Pu0w&q=85&s=7b177aca7e086e419b0e73cd4dbbe4a5" alt="Two Mention Me blocks shown on checkout page" width="1062" height="892" data-path="images/knowledge/shopify/33701698694429.png" />
  </Step>

  <Step title="Verify settings match">
    Click on both to make sure the settings match.

    <img src="https://mintcdn.com/mentionme/V2LNKGCh7ROBia07/images/knowledge/shopify/33701706998429.png?fit=max&auto=format&n=V2LNKGCh7ROBia07&q=85&s=8201d4165de0d72776e9e495dff49e87" alt="Comparing settings between old and new Mention Me blocks" width="844" height="1078" data-path="images/knowledge/shopify/33701706998429.png" />
  </Step>

  <Step title="(Optional) Remove the old widget">
    Remove the widget from the old app. If you're immediately uninstalling the old app, you don't need to remove the block right away.

    <img src="https://mintcdn.com/mentionme/V2LNKGCh7ROBia07/images/knowledge/shopify/33701706998685.png?fit=max&auto=format&n=V2LNKGCh7ROBia07&q=85&s=a19de5ca7088e158d8389a5661471f19" alt="Removing the old app widget from checkout" width="840" height="2088" data-path="images/knowledge/shopify/33701706998685.png" />

    You can identify the old block as it should be the one higher on the page.
  </Step>
</Steps>

### Example: Mention Me Refer a Friend Journey - Announcement

For announcements, there's a limit of 1 block on the Thank You and Order Status pages. You will need to remove the block from the old app before adding the new block. Note any settings before removing the old block.

<img src="https://mintcdn.com/mentionme/V2LNKGCh7ROBia07/images/knowledge/shopify/33701706998813.png?fit=max&auto=format&n=V2LNKGCh7ROBia07&q=85&s=b68145d5f7282e19b9bec750e8502b1b" alt="Announcement block limit on Thank You and Order Status pages" width="2596" height="2088" data-path="images/knowledge/shopify/33701706998813.png" />

<img src="https://mintcdn.com/mentionme/GjiDi6ZwHP27Pu0w/images/knowledge/shopify/33701698696221.png?fit=max&auto=format&n=GjiDi6ZwHP27Pu0w&q=85&s=de86f94a054e4304eb1c4ad243157045" alt="Removing old announcement block before adding new one" width="2596" height="2088" data-path="images/knowledge/shopify/33701698696221.png" />

Compare the settings between old and new apps, and adjust if needed.

<img src="https://mintcdn.com/mentionme/V2LNKGCh7ROBia07/images/knowledge/shopify/33701706999453.png?fit=max&auto=format&n=V2LNKGCh7ROBia07&q=85&s=1066f17865e806392756f1f5c8196999" alt="Comparing announcement settings between old and new apps" width="3708" height="2178" data-path="images/knowledge/shopify/33701706999453.png" />

<img src="https://mintcdn.com/mentionme/V2LNKGCh7ROBia07/images/knowledge/shopify/33701707000605.png?fit=max&auto=format&n=V2LNKGCh7ROBia07&q=85&s=453f6aacf1de7a3d1cf7b5f37fca5060" alt="Adjusted announcement settings on new app" width="3708" height="2178" data-path="images/knowledge/shopify/33701707000605.png" />

## Uninstall the Old App

Once you've verified the blocks are working correctly in the Checkout Editor, safely uninstall the old app.

<img src="https://mintcdn.com/mentionme/GjiDi6ZwHP27Pu0w/images/knowledge/shopify/33701698698525.png?fit=max&auto=format&n=GjiDi6ZwHP27Pu0w&q=85&s=a17af5298b6ab880c8992082523272a6" alt="Uninstalling the old Mention Me Shopify app" width="3708" height="2178" data-path="images/knowledge/shopify/33701698698525.png" />
