Migration Tools

LemonStand's migration tools make it easier to migrate your data and set up your store if you're currently using a difference eCommerce solution or retail platform.

Any migration can be complex, so if you need some help we've got a few options that can make things less painful. Check out the services we have available to help you out.

Migrating From LemonStand v1

LemonStand Version 1 was released July 2010 as a commercial, downloadable software. LemonStand Cloud was released December 2013, as a hosted, cloud-based eCommerce platform (SaaS). Official support for Version 1 ended December 31, 2014 and LemonStand is 100% focused on it's Cloud product going forward. For current users of v1, it is never advisable to rely on unsupported software and we strongly recommend that you migrate your online store to our cloud product.

You can find a detailed tutorial on how to migrate to LemonStand Cloud here

These tutorials will give you some step by step details for migrating from LemonStand's previous v1 licensed software platform, as well as importing product data directly from Shopify.

Migrating From LemonStand v1

LemonStand Cloud shares many similar concepts and features as LemonStand Version 1, but the software has been rebuilt from the ground up as a native cloud application to be more efficient, future proof, scaleable and secure. This means that, unfortunately, that migration between the two versions is not automatic. We do provide some tools to make the switch easier, and also provide email customer support to all Version 1 customers that are migrating.

Any migration can be complex, so if you need some help we've got a few options that can make things less painful. Check out the services we have available to help you out.

How-To Migrate From V1 To LS Cloud

The two major sources of data you can migrate are:

  1. Your products (including images)
  2. Your customers

Order history, discounts, historical reports and other data cannot be migrated at this time. We recommended that you export this data to CSV for your historical records, and for importing into financial systems like accounting software. Themes must be ported manually, or you can start fresh with a new theme on LemonStand Cloud.

Migrating products

  1. Log into your V1 store and navigate to Shop > Export Products. If you do not see this item in the menu, you should install the latest V1 updates. Do this by going to System > Modules & Updates, then checking for and installing any updates.
  2. Select the "LemonStand Cloud" export format, and select the "export image archive" checkbox if you want to migirate your product images. Click the Export CSV button.
  3. You will then have a .CSV and .ZIP file for your products downloaded to your computer from your V1 store. Now you should log into your LemonStand Cloud store admin.
  4. In your LemonStand Cloud store, navigate to Product Catalog, and click the Import button.
  5. On this page, you should click the button to select CSV file that you downloaded to your computer. Optionally, click the button to select your ZIP file button which contains the product images. Most likely you'll want to select the "Create product categories" checkbox. Once complete, click the Import button.

  • If your V1 store uses non-default tax classes and product types, you will get errors in the import if those tax classes do not already exist in your LemonStand Cloud store. You can prevent this by defining tax classes and product types of the same name prior to the import. Alternatively, you can simply delete the Tax Class and Product Type columns from the CSV file. Any imported products will then use your store's default tax class and product type.
  • If all goes well, your products should be successfully migrated from your Version 1 store to your new LemonStand Cloud store!

Migrating Customers

  1. Log into your V1 store, and navigate to Shop > Customers. You should only migrate registered customers (not guests), so make sure to filter guests out by clicking the "customer group" link under the Filter Customers section. From here, click the green Plus icons beside all groups you want to migrate, but do not include guest customers. Only the columns that are visible in the list at Shop > Customers will be exported. Make sure that all data you want to migrate is visible in the list by configuring the columns before clicking the Apply button.
    Now you can export the filtered customer list. To do that, click the Export to CSV button. You will then download a file called customer.csv to your computer.
  2. Log into your LemonStand Cloud store and navigate to Customers. Click the Import button.
  3. Click the button to select the CSV that you just downloaded to your computer. Select the "create customer groups" button if you'd like to keep customers organized in the same groups from your V1 store, and create them if they don't already exist in your LemonStand Cloud store before running the import.
  4. Click the blue Import button to complete the import.

Migrating your store design

Version 1 themes cannot be imported directly. While the theme structure is similar, there are code differences that cannot be automatically migrated.

You have two choices in terms of your approach to migrate to LemonStand's Cloud product:

1) Pick a new theme

Starting fresh with one of LemonStand's free, open source, responsive starter themes comes with a lot of benefits. It provides a solid foundation to work from which uses the latest Twig templating language and includes LemonStand Cloud specific variables and features out of the box for a quick start. From there, you can customize the theme using the built in Editor, or using LemonSync, our open source command line tool that enables you to build LemonStand Cloud themes in your local development environment.

You could even design a completely new custom theme from scratch if you have the appetite, or by working with an experienced LemonStand partner.

2) Port over your Version 1 theme

You can port over your Version 1 theme by manually copying over the HTML, CSS and custom JavaScript code (such as jQuery scripts), then replacing the dynamic PHP or V1 Twig code with equivalents for LemonStand Cloud.

Major Differences

Difference LemonStand V1 LemonStand Cloud
Hosting & Support Didn't include web hosting. Must be installed on your own server that you pay for separately. Maintenance of infrastructure, security, monitoring, etc. is your responsibility. Includes secure and scalable hosting with CDN, automated updates and technical support in a single affordable monthly price. Doesn't require any installation. You can get a store set up in 5 minutes, and start a free trial.
Development Status Discontinued. Official support ended December 31, 2014. In active development, with new features and updates being released on a weekly basis.
Theme Language Used raw PHP in themes by default, with optional Twig themes. Twig is mandatory and used by default. Twig is a dynamic templating language.
Included Themes 1 free theme was included by default. More paid themes available on the Marketplace. 13+ free responsive / mobile-friendly themes included by default, with more being released every month.
Theme Development Themes were edited using the browser-based code editor, or by editing files locally and then uploading to the web server, commonly using FTP or Git. Themes are edited using the browser-based Editor, or by editing files locally and syncing them to the cloud using the free LemonSync developer tool.
API No built-in web service or API. RESTful API access available to all customers on all pricing plans with Webhooks support also available on some plans.
Code Access Direct access to the codebase. Multi-tenant, distributed application without access to the software codebase. Functional access via the API,
Webhooks and the Twig dynamic language, plus an upcoming App Store / Marketplace. Custom data fields provides some database customization capabilities for some pricing plans.
Software Updates Updates required that you installed them manually, by running a process in the back-end of your store. No updates have been made since December, 2014 - so there is an increasing likelihood that V1 installations will become unstable as servers, operating systems, databases and other infrastructure changes. All customers automatically receive software updates (free of charge). All customers are using the latest version at all times.


  • The theme structure is very similar, including Pages, Templates, Partials and Resources (images, CSS files, JS files, etc.)
  • Many features from V1 have been ported over, or improved and reimagined for LemonStand Cloud including the Option Matrix (now called variants), tier pricing (now called Volume Pricing), product groups (now called Collections) and much more.
  • An emphasis on customization is still baked into LemonStand. We believe that all online retailers should have beautiful, customized and mobile-friendly eCommerce websites and LemonStand Cloud supports that goal more than ever.

Importing Data From Shopify

Step 1 - Create a Shopify Private App

In order to import your products into LemonStand, you need to generate an API key and password for our system to communicate with Shopify. Navigate to the Apps section of your Shopify store.

If this is the store's first private app, you'll be prompted to Create a Private App as shown below.

If there are other Apps installed as shown above, you'll need to click on the Private Apps button to view a list. From here you can click on the Create a Private App button.

Step 2 - Retrieve Your API Credentials

Review the resulting private App's details by clicking on its title from the apps menu after creating it. Here you'll see the relevant API Key, Password and URL references for connecting it to your LemonStand store.

Step 3- Configure the Shopify Import Tool

In your LemonStand store admin, navigate to Integrations > Import Tools, and copy the Store, API Key and Password from your Shopify private App into the configuration.

The "Store" field can be retrieved from the URL Format of your Shopify private app credentials. For example, if your URL Format is"https://apikey:password@hostname/admin/resource" then the store is hostname.

If you do not want to overwrite products in your existing LemonStand store, then uncheck the "Update existing products" checkbox. Also, if you do not want to create any new categories uncheck the "Create new categories" checkbox.

When you click the Import button, a job will be scheduled in our system for the import to take place when system load is minimal. You will receive an email when the import is complete, generally 15-30 minutes.