1. Overview
1.1 What is Ninja Importer?
Ninja Importer Dashboard showing completed import jobs for Customers, Products, and Orders
Ninja Importer is a Shopify-embedded data migration app built by The Shop Ninjas. It allows you to import Customers, Products, and Orders directly into your Shopify store in bulk using CSV or Excel (XLSX) files without any coding, developer involvement, or third-party migration tools.
Whether you are migrating from WooCommerce, another Shopify store, or any other e-commerce platform, Ninja Importer gives you a simple and reliable way to move your store data in three steps: download the template, fill in your data, and upload it. The app validates your file before importing, processes each row in the background, and sends you an email notification when the import is complete.
Ninja Importer supports the following data types:
- Customers — import customer profiles including names, emails, and default address details
- Products — import product listings including titles, descriptions, vendors, and categories
- Orders — import historical order records including financial status, fulfillment status, totals, and line items
1.2 Navigation Overview
Ninja Importer appears in your Shopify Admin under Apps then Ninja Importer. Once inside the app, you will find three pages in the left sidebar:
Import Data: The main upload page where you download templates, configure your import settings, upload your file, and start the import process.
Logs: A log viewer where you can review the detailed results of each individual import, including any rows that failed to process.
Pricing: The plan comparison page where you can view the limits of your current plan and upgrade to Pro if needed.
2. Dashboard (Home)
The Ninja Importer Dashboard is the first screen you see when you open the app. It gives you a live summary of all the data that has been successfully imported into your Shopify store, along with a history of recent import jobs.
2.1 Summary KPI Cards
Customers Imported: The total number of customer records that have been successfully imported across all import jobs.
Products Imported: The total number of product records that have been successfully imported across all import jobs.
Orders Imported: The total number of order records that have been successfully imported across all import jobs.
2.2 Recent Imports List
Below the summary cards, the Recent Imports section shows a chronological list of all import jobs that have been run. Each import entry displays the type of data imported (Customers, Products, or Orders), the date and time the import was started, a progress bar showing how many rows were processed out of the total, the completion percentage, and a status badge showing whether the import is Completed, In Progress, or Failed. Each import job runs independently so you can track the progress of each data type separately.
2.3 Clear All
The Clear All button in the top right corner of the dashboard clears the Recent Imports history list from the dashboard view. This does not delete any imported data from your Shopify store — it only clears the visual history on the dashboard screen.
3. Import Data
Import Data page showing the correct upload order notice, Download Templates section, and Configure Upload form
The Import Data page is where all importing takes place. You access it by clicking Import Data in the Ninja Importer sidebar. The page is divided into two main sections: Download Templates and Configure Upload.
3.1 Important Import Order
Before uploading any files, it is critical to follow the correct import sequence. Ninja Importer displays a notice at the top of the Import Data page reminding you of this order. You must always import your data in the following sequence:
- Customers first
- Products second
- Orders third
This order is required because Orders reference both Customers and Products. If you attempt to import Orders before the related Customers and Products exist in your Shopify store, the order rows will fail to link correctly. Always complete the Customers import and the Products import before starting the Orders import.
3.2 Download Templates
The Download Templates section provides ready-made template files for each data type. If you are not sure how to format your data, start here. You can switch the template format between CSV and Excel (XLSX) using the Format dropdown in the top right corner of the section. Both formats are fully supported by Ninja Importer.
Customers Template: Downloads a pre-formatted file with all the required and optional column headers for importing customer data.
Products Template: Downloads a pre-formatted file with all the required and optional column headers for importing product data.
Orders Template: Downloads a pre-formatted file with all the required and optional column headers for importing order data.
3.3 Template Formats
Customers CSV template open in Excel — showing columns for Customer ID, First Name, Last Name, Email, address fields, and more
Products CSV template open in Excel — showing columns for Handle, Title, Body (HTML), Vendor, Product Category, and more
Orders CSV template open in Excel — showing columns for Name, Email, Financial Status, Paid at, Currency, Total, and line item fields
Each template file contains a header row with the exact column names that Ninja Importer expects. You fill in your data starting from row 2, with one record per row. The templates are designed to be opened and edited in CSV or XLSX files.
The Customers template includes columns for Customer ID, First Name, Last Name, Email, Accepts Email Marketing, and full default address fields including Company, Address1, Address2, City, Province, and Country.
The Products template includes columns for Handle, Title, Body (HTML), Vendor, and Product Category. The Handle column is the unique URL-safe identifier for each product and is required. Products with multiple variants will have multiple rows sharing the same Handle value.
The Orders template includes columns for Name (order number), Email, Financial Status, Paid at, Fulfillment Status, Currency, Subtotal, Shipping, Taxes, Total, Discount Code, Discount Amount, Shipping Method, and Created at. Each order can span multiple rows when it contains multiple line items.
It is important to keep the header row exactly as it appears in the template. Do not rename, reorder, or remove any column headers as this will cause the import to fail validation.
3.4 Configure Upload
Data type dropdown showing the three options: Customers, Products, and Orders
File Type dropdown showing CSV File and Excel XLSX options
The Configure Upload section is where you set up your import before uploading your file. It contains three settings.
What type of data are you uploading? Click this dropdown to select the data type you want to import. The three options are Customers, Products, and Orders. Make sure this selection matches the file you are about to upload.
File Type: Click this dropdown to select the format of your file. You can choose between CSV File and Excel (XLSX). Select the format that matches your prepared file.
Notification Email (Optional): Enter your email address in this field if you would like to receive an email notification when the import finishes. This is particularly useful for large imports that may take several minutes to process in the background.
3.5 Running the Import
Configure Upload with a file attached and the Validate & Start Import button highlighted
Once you have selected the data type, file type, and optionally entered your email, upload your file by clicking Add .csv file (or Add .xlsx file) inside the upload area, or by dragging and dropping your file directly into the dashed upload box. The file name and size will appear in the upload area once the file is attached successfully.
After attaching your file, click the Validate & Start Import button in the bottom right corner. Ninja Importer will first validate your file to check that the headers are correct and the data is properly formatted. If any validation errors are found, the app will display them so you can correct your file before retrying. If the file passes validation, the import begins immediately and runs in the background.4. Step-by-Step Import Guide
This section walks you through the complete process of importing each data type from start to finish, in the correct order.
4.1 Importing Customers
Dashboard after Customers import — Customers Imported card highlighted showing 10 records successfully imported
Email notification confirming the CUSTOMERS import completed with 10 rows successfully processed and 0 failures
- Go to Apps then Ninja Importer, and click Import Data in the sidebar.
- In the Download Templates section, click Customers Template to download the template file.
- Open the downloaded template in Excel or Google Sheets and fill in your customer data starting from row 2. Each row represents one customer.
- Save the file in CSV or XLSX format.
- Back in Ninja Importer, under Configure Upload, select Customers from the data type dropdown.
- Select the matching File Type (CSV File or Excel XLSX).
- Optionally enter your Notification Email.
- Click Add .csv file or drag and drop your file into the upload area.
- Click Validate & Start Import.
- Once the import completes, return to the Dashboard to confirm the Customers Imported count has updated correctly.
4.2 Importing Products
Configure Upload set to Products with the products file attached and ready to import
Dashboard after Products import — Products Imported card highlighted showing 10 records successfully imported
- After completing the Customers import, click Import Data in the sidebar.
- In the Download Templates section, click Products Template to download the template file.
- Open the template and fill in your product data. Each row represents one product variant. Products with multiple variants will have multiple rows sharing the same Handle value.
- Save the file in CSV or XLSX format.
- Under Configure Upload, select Products from the data type dropdown.
- Select the matching File Type.
- Optionally enter your Notification Email.
- Upload your file and click Validate & Start Import.
- Once complete, confirm the Products Imported count on the Dashboard has updated.
4.3 Importing Orders
Dashboard after Orders import — Orders Imported card highlighted showing 7 records successfully imported
- After completing both the Customers and Products imports, click Import Data in the sidebar.
- In the Download Templates section, click Orders Template to download the template file.
- Open the template and fill in your order data. Orders with multiple line items will have multiple rows sharing the same order Name (number).
- Save the file in CSV or XLSX format.
- Under Configure Upload, select Orders from the data type dropdown.
- Select the matching File Type.
- Optionally enter your Notification Email.
- Upload your file and click Validate & Start Import.
- Once complete, confirm the Orders Imported count on the Dashboard has updated.
5. Email Notifications
Import Completed email received in Gmail after the CUSTOMERS import finished processing
If you entered a Notification Email before starting an import, Ninja Importer will automatically send you an email when that import finishes processing. The email is sent from NinjasImporter and arrives with the subject line Import Completed followed by the data type, for example Import Completed: CUSTOMERS.
The email body confirms that the import has finished and shows a summary of the results, including the Total Rows processed, the number of rows Successfully Processed, and the number of Failed rows. If all rows were processed successfully the Failed count will show zero. The email also includes a link back to your store’s Ninja Importer dashboard where you can view the detailed logs and investigate any failures.
Email notifications are optional but recommended for large imports, as the processing happens in the background and may take several minutes to complete depending on the size of your file and your current plan limits.
6. Logs
Import Logs page showing the filter dropdown and log entries
The Logs page provides a detailed record of every import that has been run through Ninja Importer. To access it, click Logs in the sidebar. Each log entry corresponds to one import job and shows the individual row-level results of the processing.
You can filter the logs by export type using the Filter by Export Type dropdown at the top of the page. This allows you to view only the logs for a specific data type such as Customers, Products, or Orders.
If an import has completed with some failures, the log will highlight the specific rows that failed and the reason for each failure, helping you correct your data file and re-run just the failed rows if needed. If no imports have been run yet, or if the log history has been cleared, the Logs page will display a No logs found message. You can use the pagination controls at the bottom of the page to browse through older log entries.
7. Pricing
Pricing page showing the Basic Plan (free) and Pro Plan ($9.99/month) side by side with their import limits
Ninja Importer offers two plans. To view or change your plan, click Pricing in the sidebar.
7.1 Basic Plan (Free)
The Basic Plan is free forever and is designed for merchants who are getting started or have smaller stores with moderate data volumes. It is the default plan when you first install the app. The Basic Plan supports the following limits per file upload:
- Up to 100 Products per import
- Up to 1,000 Customers per import
- Up to 500 Orders per import
7.2 Pro Plan
The Pro Plan is designed for growing stores that need to import larger volumes of data in bulk. It is available at $9.99 per month, with a yearly billing option also available. The Pro Plan supports the following limits per file upload:
- Up to 8,000 Products per import
- Up to 5,000 Customers per import
- Up to 4,000 Orders per import
To upgrade from the Basic Plan to the Pro Plan, click the Upgrade button on the Pricing page and complete the billing process through Shopify’s standard subscription flow.
8. Support & Resources
If you need help with Ninja Importer, the following resources are available to you.
Documentation: https://theshopninjas.com/docs
Plans & Pricing: Navigate to Apps then Ninja Importer and click Pricing in the sidebar inside Shopify Admin.
Support: https://theshopninjas.com/contact-us
Website: https://theshopninjas.com
Ninja Importer is a product of The Shop Ninjas — making Shopify store migrations simple and stress-free.
