---
title: Importing Your Order History
description: "Deep Insights keeps its own analytics tables, built from your WooCommerce orders. The first time you activate the plugin, it imports your existing order history into those tables. Table of Contents [Toggle](#) - [How the import works](#How_the_import_works) - [Check the…"
url: "https://wpruby.com/knowledgebase/deep-insights-importing-order-history/"
updated: "2026-11-13"
category: Deep Insights for WooCommerce
---

# Importing Your Order History

Deep Insights keeps its own analytics tables, built from your WooCommerce orders. The first time you activate the plugin, it imports your existing order history into those tables.

Table of Contents

 [Toggle](#)

- [How the import works](#How_the_import_works)
- [Check the import status](#Check_the_import_status)
- [New orders after the import](#New_orders_after_the_import)
- [Rebuild from order history](#Rebuild_from_order_history)
- [Failed orders](#Failed_orders)
- [If the import seems stuck](#If_the_import_seems_stuck)

## How the import works

- The import starts automatically on activation.
- It runs in the background with WooCommerce's Action Scheduler, in small batches, so it does not slow down your store.
- You can close the dashboard; the import keeps going.
- If it is interrupted, it resumes where it left off. A watchdog checks every 10 minutes and restarts a stalled import.

While the import runs, the dashboard shows a progress bar, for example "1,200 of 5,000 orders processed (24%)". Reports are marked as incomplete until it finishes.

How long it takes depends on your hosting and the number of orders. Most stores finish within minutes; stores with hundreds of thousands of orders can take an hour or more on modest hosting.

## Check the import status

Go to **WooCommerce → Deep Insights → Settings**. The **Data** card shows:

- **Order storage**: HPOS or legacy posts storage.
- **Import status**: running, complete or idle.
- **Last complete import**: when the last full import finished.
- **Pending live changes**: new or edited orders waiting to be synced.
- **Failed orders**: orders that could not be read.

[![The Data card in Settings showing the import status](https://cdn.wpruby.com/wp-content/uploads/2026/11/13142824/deep-insights-docs-settings.png)](https://cdn.wpruby.com/wp-content/uploads/2026/11/13142824/deep-insights-docs-settings.png)

## New orders after the import

You don't need to import again. New orders, edits, status changes, refunds and deletions are picked up automatically and synced in the background within moments.

Cached reports refresh at most every 5 minutes after order changes, so the dashboard stays fast on busy stores. You can change this interval in Settings.

## Rebuild from order history

Use **Settings → Data → Rebuild from order history** when you want to re-read every order, for example after:

- changing the site timezone
- adding a cost-of-goods integration and wanting costs for past orders
- restoring a database backup

A rebuild keeps your existing figures visible while it runs and updates each order in place. Orders that were deleted from WooCommerce are removed at the end.

## Failed orders

If an order cannot be read (for example, because another plugin throws an error while loading it), Deep Insights retries it once. Orders that still fail are listed in **Settings → Data → Orders that failed to import**, with the error message, and a notice appears on the dashboard.

Failed orders keep their previous analytics data. Fix the cause and run a rebuild to bring them in.

## If the import seems stuck

The import relies on WordPress background jobs. If background jobs don't run on your site, see [Troubleshooting](https://wpruby.com/knowledgebase/deep-insights-troubleshooting/).

You can also click **Resume if stalled** in Settings while an import is running.