> For the complete documentation index, see [llms.txt](https://subscriptions-docs.tech-arms.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://subscriptions-docs.tech-arms.io/features/subscriptions/migration.md).

# Migration

Move subscriptions from another subscription app to TA Subscriptions App with a CSV file, without asking customers to subscribe again.

If you are switching from another subscription app, you can import your existing subscriptions with a CSV file. Customers keep their products, prices, schedule, and saved payment method, and they do not need to subscribe again.

## Before you start

Make sure that:

* the customers already exist in your Shopify store,
* the product variants in the subscriptions exist in your store,
* the customers' payment methods are saved in Shopify,
* the selling plans you want to use are created in TA Subscriptions App. See [Create a selling plan](https://subscriptions-docs.tech-arms.io/features/subscription/how-to-create-a-subscription-plan.md).

Keep your old app running until you have checked that the imported subscriptions renew correctly, then stop renewals in the old app so customers are not charged twice.

## Import your subscriptions

{% stepper %}
{% step %}

### Open the Import window

In the app menu, click **Subscriptions**, then click **Import** in the top-right corner. The **Import subscription data by CSV** window opens.

![The Import subscription data by CSV window with Add file and the sample file link highlighted](https://3752025337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F479XnzvtVA5dDE3Rt2Uh%2Fuploads%2FI802cu94f4PlRD4zKbbF%2Fsubscriptions-import-window.png?alt=media)
{% endstep %}

{% step %}

### Download the sample file

Click **sample file** to download a CSV template. Each row is one subscription, and the columns are explained in [CSV columns](#csv-columns) below.
{% endstep %}

{% step %}

### Fill in your data

Export your subscriptions from your old app and copy the data into the template. Keep every column of the template, in any order, and do not add other columns. Leave a column empty when it does not apply.

To add more than one product to a subscription, add another row with the same **handle** and fill in only the `line_` columns.
{% endstep %}

{% step %}

### Upload the file

Click **Add file**, choose your CSV file, then click **Upload file**. A progress bar on the Subscriptions page shows how many subscriptions have been imported. You can run only one import at a time.

If the file has errors, the app lists each error with the columns and handles affected. Fix the file and upload it again.
{% endstep %}

{% step %}

### Check the result

Open a few imported subscriptions and check the products, prices, next billing date, and shipping address. Watch the first renewal to make sure it is charged as expected.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Start with a small file of a few subscriptions. Once they import correctly, import the rest.
{% endhint %}

## CSV columns

| Column                                                                  | What to enter                                                                                              | Example                            |
| ----------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| `handle`                                                                | A unique ID for the subscription, usually its ID in your old app. Letters, numbers, and dashes only.       | `18193744194`                      |
| `upcoming_billing_date`                                                 | The next billing date, in UTC and ISO 8601 format. It must be at least 24 hours after you import the file. | `2026-12-10T08:00:00Z`             |
| `customer_id`                                                           | The Shopify customer ID.                                                                                   | `6753288945986`                    |
| `currency_code`                                                         | The currency, as a 3-letter code in capital letters.                                                       | `USD`                              |
| `status`                                                                | `ACTIVE`, `PAUSED`, `CANCELLED`, `FAILED`, or `EXPIRED`.                                                   | `ACTIVE`                           |
| `cadence_interval`                                                      | The billing unit: `DAY`, `WEEK`, `MONTH`, or `YEAR`.                                                       | `WEEK`                             |
| `cadence_interval_count`                                                | The number of units between orders, from 1 to 100.                                                         | `1`                                |
| `customer_payment_method_id`                                            | The ID of the customer's saved payment method in Shopify.                                                  | `01e223e878df3370beeb09c2c2912842` |
| `delivery_price`                                                        | The shipping fee per order. 0 or more, up to 2 decimal places.                                             | `10`                               |
| `delivery_method_type`                                                  | `SHIPPING`, `LOCAL_DELIVERY`, or `PICKUP`.                                                                 | `SHIPPING`                         |
| `delivery_address_first_name`, `delivery_address_last_name`             | The recipient's name.                                                                                      | `Jane`, `Lee`                      |
| `delivery_address_address1`, `delivery_address_address2`                | The street address, and the apartment or suite.                                                            | `123 Main St`                      |
| `delivery_address_city`                                                 | The city.                                                                                                  | `New York`                         |
| `delivery_address_province_code`                                        | The state or province code.                                                                                | `NY`                               |
| `delivery_address_country_code`                                         | The 2-letter country code.                                                                                 | `US`                               |
| `delivery_address_company`                                              | The company name.                                                                                          | `Acme Inc`                         |
| `delivery_address_zip`                                                  | The postal or ZIP code.                                                                                    | `10001`                            |
| `delivery_address_phone`                                                | The delivery phone number.                                                                                 | `17203207896`                      |
| `delivery_local_delivery_phone`, `delivery_local_delivery_instructions` | The phone number and instructions for local delivery.                                                      | `Leave at front desk`              |
| `delivery_pickup_method_location_id`                                    | The Shopify location ID, for pickup.                                                                       | `987654321`                        |
| `line_variant_id`                                                       | The Shopify product variant ID. Required on every row.                                                     | `44340746715458`                   |
| `line_quantity`                                                         | The quantity per order, 1 or more. Required on every row.                                                  | `1`                                |
| `line_current_price`                                                    | The price per unit the customer pays. Required on every row.                                               | `29.99`                            |
| `line_selling_plan_id`                                                  | The ID of the selling plan for this product. Optional.                                                     | `3607724288`                       |
| `line_selling_plan_name`                                                | The selling plan name shown to the customer. Optional.                                                     | `Monthly subscription`             |

*If you need help, feel free to reach out to us via in-app* [***Live chat***](https://go.crisp.chat/chat/embed/?website_id=c4ae10a3-f762-4968-b35a-c931caf62a96)***,*** [***Book a call***](https://calendly.com/ta-subscription-app-support/30min) *or at* [***support@tech-arms.io***](mailto:support@tech-arms.io)***.***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://subscriptions-docs.tech-arms.io/features/subscriptions/migration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
