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

**1. Go to the importing page**

From **Gameball Admin Dashboard**, go to **Customers > Customers Section > More > Update Customers**.

![Update customers menu](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)

**2. Choose the old Loyalty Program**

Choose the former loyalty program from the following list:

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

![Select loyalty program](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)

> [!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](https://docs.gameball.co/product-documentation/understanding-your-customers/your-customers/import-customers-using-csv.md).

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

![Click to upload](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)

**3. Upload your extracted customer file**

Choose the downloaded CSV file and click **Open**.

![Select CSV file](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)

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

![Continue after upload](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)

**4. 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.

![Attribute mapping](https://mintcdn.com/gameball/-Vx3w6lBtPqm7VVl/images/product-docs/understanding-your-customers/attribute-mapping.png?fit=max\&auto=format\&n=-Vx3w6lBtPqm7VVl\&q=85\&s=7a2d866f8b79741256f01d32b175eb89)

> [!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.

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

![Tiering-up recalculation method](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)

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.

![Date format selection](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)

Choose between:

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

Click **Import**.

![Import button](https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/import-button.png?fit=max\&auto=format\&n=H7x6P2yERgCfU542\&q=85\&s=8640a4f86cdafa60a825fdcadfa5176d)

**5. 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.

![Error review screen](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)

> [!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.

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

**6. 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.

![Migration complete](https://mintcdn.com/gameball/H7x6P2yERgCfU542/images/product-docs/understanding-your-customers/migration-complete.png?fit=max\&auto=format\&n=H7x6P2yERgCfU542\&q=85\&s=15b1a891ed84bd488b83686b41f262ab)

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

> [!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.

***

## 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](https://docs.gameball.co/product-documentation/guides-strategies-faqs/supportive-guides/integrate-guest-customers.md).

***

## How to Extract Your Current Customer Data

**1. Go to Customers**

Go to your **Customers section** on **Gameball Admin Dashboard**.

**2. Export the data**

On the top right of the page, click **More**, then **Extract**.

![Extract customer data](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)

***

## What Else?

> [card] [Explore a Customer Profile](https://docs.gameball.co/product-documentation/understanding-your-customers/customer-profile/explore-and-manage-a-customer-profile.md)
>
> Learn more about your customer's data.

> [card] [Common Migration Errors](https://docs.gameball.co/product-documentation/understanding-your-customers/your-customers/common-customer-migration-errors.md)
>
> Common customer update/migration errors and how to fix them.

> [card] [Import Customers via CSV](https://docs.gameball.co/product-documentation/understanding-your-customers/your-customers/import-customers-using-csv.md)
>
> Import your customers from other loyalty programs using a CSV file.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.