# How can I migrate from another subscription app to Joy?

This guide will walk you through the process of migrating your subscription data from your current subscription app to Joy Subscription. Follow these steps to ensure a smooth transition with minimal disruption to your customers.

<figure><img src="https://3187547448-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F787e7bihi5DEAqHqyely%2Fuploads%2FJa3Z0vtqrtARMwsQXRre%2FHarry&#x27;s.png?alt=media&#x26;token=e3feb669-b7ca-4686-ba48-8eb6cc382c08" alt=""><figcaption><p>Migration to Joy Subscription</p></figcaption></figure>

## Requirements before migration

Before beginning the migration process, please ensure your store meets these requirements:

* Your store uses **Shopify Checkout**
* Your current subscription app is one of the supported apps in the **Shopify ecosystem** (Appstle, Seal, Recharge Shopify checkout, Subify, etc.)
* Your payment gateway is one of the [**5 payment gateways supported by Shopify**](https://help.shopify.com/en/manual/products/purchase-options/subscriptions/shopify-subscriptions/considerations)
* Your subscriptions are either **pay-as-you-go or prepaid subscriptions**

{% hint style="warning" %}
**Note:** During migration, order history and analytics data from your previous subscription app will not be transferred.
{% endhint %}

## Migration process overview

The migration process consists of three main phases:

1. **Pre-migration** - Setting up Joy Subscription
2. **Migration process** - Transferring your subscription data
3. **Post-migration** - Verifying the migration and cleaning up your old subscription app

Let's walk through each phase step by step.

### 1. Pre-migration

These steps prepare your store for migration while ensuring

* The new data related to your subscription business will be located in Joy Subscription
* Joy works properly with your current subscriptions and matches your needs&#x20;

#### Install Joy Subscription

You can install Joy Subscription [**here**](https://apps.shopify.com/joy-subscription)

#### Set up your subscription products in Joy Subscription

Please refer to [**this guide**](https://docs.avada.io/joy-subscriptions/features/subscription-plan) for subscription products setup in Joy Subscription

#### Place a test order

Before proceeding with migration, place a test subscription order to ensure Joy is working properly.

#### Remove subscription products/plans and disable subscription widget in your current app

1. In your current subscription app, locate your subscription products or plans
2. Delete or deactivate these products/plans
3. Make sure subscription options are no longer visible on your store

### 2. Migration Process

Now that Joy is set up and your store is prepared, you can migrate your existing subscription data.

#### Export data from your current app

1. Export your subscription data as CSV
2. Save this file to your computer

#### Prepare your import file

The export file from your current app may need formatting to match Joy' requirements.&#x20;

{% hint style="success" %}
Please check the sample file [**here**](https://docs.google.com/spreadsheets/d/1ZhrfAJAhV0OMn6yHv9A-_nJjpU4KhhERGEwb3DRharU/edit?gid=0#gid=0).
{% endhint %}

#### Send the properly formatted file to our support team

We will take care of the migration process and make sure it works correctly.

### 3. Post-migration

After importing your subscription data, follow these steps to finalize the migration process.

#### Verify imported subscriptions

1. In Joy Subscriptions, check the **Subscriptions** section
2. Compare the number of imported subscriptions with your original data
3. Examine a sample of subscriptions to ensure all details were imported correctly:
   * Customer information
   * Product details
   * Subscription intervals
   * Next billing dates

#### Cancel subscriptions in your previous app

To prevent customers from being charged twice:

1. Go to your previous subscription app
2. Locate all active subscriptions
3. Cancel all subscriptions

{% hint style="warning" %}
**Important:** This step is critical to prevent double-charging your customers!
{% endhint %}

#### Uninstall your previous subscription app

Once you've verified all subscriptions are working correctly in Joy Subscriptions, you can uninstall the previous subscription app.

By following this guide, you should be able to successfully migrate your subscription data to Joy Subscriptions with minimal disruption to your business operations. Remember to test thoroughly before and after migration to ensure everything is working as expected.