> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gameball.co/llms.txt
> Use this file to discover all available pages before exploring further.

# How Do I Migrate My Customers to Gameball From Other Loyalty Programs on Shopify?

> Learn how to easily migrate customers to Gameball from other loyalty programs like Growave, Yotpo, LoyaltyLion, Stamped, Smile.io.

Thank you for deciding to switch to Gameball for your rewards program! To migrate your customers from any other loyalty program to Gameball, all you need is to go through some easy, quick steps. Check out this video, or follow the steps below.

***

## Step 1: Export Old Rewards Program Data

All you need to do is head to your current rewards program and ask for your customers' export files.

Pause your current loyalty program on the old platform, and follow the next step to complete the migration process.

***

## Step 2: Migrate to Gameball

<Steps>
  <Step title="Go to the importing page">
    From **Gameball Admin Dashboard**, go to **Customers > Customers Section > More > Update Customers**.

    <Frame>
      <img src="https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/update-customers-menu.png?fit=max&auto=format&n=H7x6P2yERgCfU542&q=85&s=b6a77a9f2134c4c635f4772cb984762c" alt="Update customers menu" width="2558" height="1236" data-path="images/product-docs/understanding-your-customers/update-customers-menu.png" />
    </Frame>
  </Step>

  <Step title="Choose the old Loyalty Program">
    Choose the former loyalty program from the following list:

    * Growave
    * Yotpo
    * LoyaltyLion
    * Stamped
    * Smile.io

    <Frame>
      <img src="https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/select-loyalty-program.png?fit=max&auto=format&n=H7x6P2yERgCfU542&q=85&s=5d1287dffcbf99dea1f3319997a00a98" alt="Select loyalty program" width="2550" height="1410" data-path="images/product-docs/understanding-your-customers/select-loyalty-program.png" />
    </Frame>

    <Note>
      If the former loyalty engine you were using is not in the list or you are not a Shopify user, choose **CSV** and follow [the steps here](/product-documentation/understanding-your-customers/your-customers/import-customers-using-csv).
    </Note>

    Click on **"Click to upload."**

    <Frame>
      <img src="https://mintcdn.com/gameball/-Vx3w6lBtPqm7VVl/images/product-docs/understanding-your-customers/click-to-upload.png?fit=max&auto=format&n=-Vx3w6lBtPqm7VVl&q=85&s=bbddd87d4b41893bdc6bc930e202d380" alt="Click to upload" width="2532" height="1392" data-path="images/product-docs/understanding-your-customers/click-to-upload.png" />
    </Frame>
  </Step>

  <Step title="Upload your extracted customer file">
    Choose the downloaded CSV file and click **Open**.

    <Frame>
      <img src="https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/select-csv-file.png?fit=max&auto=format&n=H7x6P2yERgCfU542&q=85&s=d2373cfa42e5a122f93c6c49c58b576e" alt="Select CSV file" width="3034" height="1618" data-path="images/product-docs/understanding-your-customers/select-csv-file.png" />
    </Frame>

    Once the file is read by Gameball, click **Continue.**

    <Frame>
      <img src="https://mintcdn.com/gameball/-Vx3w6lBtPqm7VVl/images/product-docs/understanding-your-customers/continue-after-upload.png?fit=max&auto=format&n=-Vx3w6lBtPqm7VVl&q=85&s=792aac8bae1f7325738040520c7d3854" alt="Continue after upload" width="1754" height="438" data-path="images/product-docs/understanding-your-customers/continue-after-upload.png" />
    </Frame>
  </Step>

  <Step title="Map your attributes">
    In order for Gameball to correctly place the customers' data into their corresponding attributes, you will have to map the CSV file headers with Gameball's requested attributes.

    For example: if the CSV file has a column titled "Email address," then select this header under **Your File Attribute**, right beside **"Customer Email."** This way Gameball will understand that data under the "Email Address" column should be placed in the **Customer Email** attribute and so on.

    <Frame>
      <img src="https://mintcdn.com/gameball/-Vx3w6lBtPqm7VVl/images/product-docs/understanding-your-customers/attribute-mapping.png?fit=max&auto=format&n=-Vx3w6lBtPqm7VVl&q=85&s=7a2d866f8b79741256f01d32b175eb89" alt="Attribute mapping" width="3038" height="1620" data-path="images/product-docs/understanding-your-customers/attribute-mapping.png" />
    </Frame>

    <Note>
      The only mandatory data/customer attribute is the **Customer Identifier** which could be placed with the email address if no unique ID/number is assigned to each customer.
    </Note>

    Choose the Tiering-up Recalculation Method by clicking on the **Edit Icon** under **"Tier Name"**.

    <Frame>
      <img src="https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/tiering-up-recalculation.png?fit=max&auto=format&n=H7x6P2yERgCfU542&q=85&s=2e91e882c2b87d26acc0cfa41b8d1974" alt="Tiering-up recalculation method" width="2384" height="1248" data-path="images/product-docs/understanding-your-customers/tiering-up-recalculation.png" />
    </Frame>

    Choose between:

    * Customers will be re-evaluated with the next recalculation cycle based on your tier expiry configuration.
    * Customers are placed into this tier forever with no later evaluation.
    * Customers are placed into this tier till a specific date.

    If you are adding the customers' birth dates, choose date format under **Date of Birth** and choose the format that matches the one in the CSV file.

    <Frame>
      <img src="https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/date-format-selection.png?fit=max&auto=format&n=H7x6P2yERgCfU542&q=85&s=54102b887358e811e2d101baf5ff1375" alt="Date format selection" width="2454" height="1446" data-path="images/product-docs/understanding-your-customers/date-format-selection.png" />
    </Frame>

    Choose between:

    * YYYY-MM-DD
    * MM-DD-YYYY
    * DD-MM-YYYY
    * YYYY/MM/DD
    * DD/MM/YYYY
    * MM/DD/YYYY

    Click **Import**.

    <Frame>
      <img src="https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/import-button.png?fit=max&auto=format&n=H7x6P2yERgCfU542&q=85&s=8640a4f86cdafa60a825fdcadfa5176d" alt="Import button" width="2844" height="1610" data-path="images/product-docs/understanding-your-customers/import-button.png" />
    </Frame>
  </Step>

  <Step title="Review your errors">
    If the CSV file you uploaded has unmatching data that doesn't comply with the original format, Gameball will show you the errors that need to be fixed for a successful migration.

    <Frame>
      <img src="https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/error-review-screen.png?fit=max&auto=format&n=H7x6P2yERgCfU542&q=85&s=7985b08524cdb3920426d840485da1c7" alt="Error review screen" width="3036" height="1622" data-path="images/product-docs/understanding-your-customers/error-review-screen.png" />
    </Frame>

    <Note>
      If there are more than 10 errors in the file, you will need to **download** the error sheet to check all your errors, as you will not see all the errors on the reviewing page.
    </Note>

    After fixing all the errors on the sheet, click **re-upload**.

    If you find that the addressed errors will not cause a problem, click **Submit**.
  </Step>

  <Step title="Submit the file to complete the migration">
    If you have fixed all your errors, you can submit your file.

    You will then be redirected to the Customers page, where you will find the list of the new customers added, as well as a sheet of all the existing errors to be downloaded.

    <Note>
      An email will be sent with the errors sheet to the admin account's registered email.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/migration-complete.png?fit=max&auto=format&n=H7x6P2yERgCfU542&q=85&s=15b1a891ed84bd488b83686b41f262ab" alt="Migration complete" width="3032" height="1602" data-path="images/product-docs/understanding-your-customers/migration-complete.png" />
    </Frame>

    The migration/customer update process is now over, and the new customers are now part of your Gameball loyalty program.
  </Step>
</Steps>

<Warning>
  **Important notes:**

  * If you are a Shopify user, you can only update the information of existing customers from your customer list that was automatically migrated to Gameball during the integration process. As for non-Shopify users, by following this process, you will be able to migrate your customers or update the information of existing ones.
  * In the case of updating the data of an existing customer, any value in the migration sheet overrides what exists in the system. For example: if the customer has 300 points in the system and the sheet value for the same customer is 100, the customer's balance will be 100 after the successful migration. If the customer has 0 points on the sheet, the customer's balance will be 0 after migration. If the points cell is empty, the customer balance will remain 300.
</Warning>

***

## How to Migrate Guests (Customers Who Are Not Registered)

When migrating your customers from other loyalty programs or through a CSV file, some of the customers' data might not be registered. If you still want these customers to be part of your loyalty program, you will have to enable guest customers to integrate them with your loyalty program. [Learn how to integrate your guest customers into your rewards program](/product-documentation/integrations/integrating-guest-customers).

***

## How to Extract Your Current Customer Data

<Steps>
  <Step title="Go to Customers">
    Go to your **Customers section** on **Gameball Admin Dashboard**.
  </Step>

  <Step title="Export the data">
    On the top right of the page, click **More**, then **Extract**.

    <Frame>
      <img src="https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/extract-customer-data.png?fit=max&auto=format&n=H7x6P2yERgCfU542&q=85&s=67c18ddbc70661f94c42e23efcdbd1d2" alt="Extract customer data" width="3030" height="1604" data-path="images/product-docs/understanding-your-customers/extract-customer-data.png" />
    </Frame>
  </Step>
</Steps>

***

## What Else?

<CardGroup cols={2}>
  <Card title="Explore a Customer Profile" icon="user" href="/product-documentation/understanding-your-customers/customer-profile/explore-and-manage-a-customer-profile">
    Learn more about your customer's data.
  </Card>

  <Card title="Common Migration Errors" icon="circle-exclamation" href="/product-documentation/understanding-your-customers/your-customers/common-customer-migration-errors">
    Common customer update/migration errors and how to fix them.
  </Card>

  <Card title="Import Customers via CSV" icon="file-csv" href="/product-documentation/understanding-your-customers/your-customers/import-customers-using-csv">
    Import your customers from other loyalty programs using a CSV file.
  </Card>
</CardGroup>
