How do I credit past Shopify orders with giveaway entries?

The Shopify Order Import tool lets you import past orders directly from your Shopify store by order number range. Each order goes through the same pipeline as live Shopify webhooks, so all purchase rules, bundle rules, AOV boosters and Klaviyo events fire exactly as they would for a regular order.

When to use this tool

• Migrating from another giveaway app: import orders placed before you switched to Giveaway Ninja, so those customers get their entries. Switching from ViralSweep or Gleam? Compare them with Giveaway Ninja first.
• Retroactive entries: you launched your giveaway after some orders were already placed, and want to award entries for those past purchases.
• Missed webhooks: if Shopify failed to deliver a webhook for an order, you can re-import it to make sure entries are awarded. You can spot these in your order logs.

How it works

1. Go to Tools in the dashboard menu and click Import Shopify Orders
2. Enter the order number range you want to import (up to 50 orders per batch)
3. Click CHECK ORDERS. The tool shows a preview of every order found, with its email, total and whether it's already been imported
4. Choose where the orders go. Automatic (same as live orders) is the default: each order goes to the giveaway a live order would reach (see below). Or pick one giveaway to credit every order to it
5. Click IMPORT ORDERS. Each order is processed in turn, and you can follow the progress in real time

Re-importing orders

If an order has already been imported, it shows an "Already Imported" badge in the preview. Orders a live webhook already processed show it too. You can still re-import it by checking "Include already-imported orders". The entries the order earned before are rolled back first, even when they are in a different giveaway, then the order is processed again in its current state, so a re-import never adds entries twice. The earlier record stays in your order logs with the status rolled-back-reimport.

Re-importing also brings an order up to date after a partial refund when the refund webhook is off: the new import counts only the units and amounts that weren't refunded. Cancelled orders are skipped and never earn entries.

Automatic: one giveaway per shop

With Automatic (same as live orders) selected, the import picks the giveaway for each order exactly like a live Shopify order:

• A POS order goes to the giveaway whose POS Orders Locations selects its shop. If you run one giveaway per retail shop, each shop's orders land in its own giveaway in a single import.
• Other orders, and POS orders from a shop no giveaway selects, go to the giveaway the customer already entered, otherwise to the newest giveaway with Auto Signup on, among the giveaways without a location filter.
• Only running giveaways are used. To import orders into a giveaway that has ended, pick it in the dropdown instead.

The preview's Giveaway check column shows where each order is going before you import, and each import result names the giveaway that received the order.

Giveaways limited to certain locations or order sources

The preview shows a Giveaway check column for the giveaway selected in the dropdown, and updates it when you pick another giveaway. It covers two settings:

• Order Routing by Location: if the giveaway uses POS Orders Locations, an order from a location the giveaway does not count is recorded as filtered-out with zero entries instead of being credited. Pick the giveaway that selects that location to import it.
• Order Source: if the giveaway counts only some order sources (for example Online Store Only), an order from another source (for example a POS order) is processed but earns no entries. The import result says why, for example: "pos" order, but this giveaway's Order Source is Online Store Only.