# Configure Shopify order import
URL: https://support.starshipit.com/articles/90200000000204-configure-shopify-order-import
Canonical: https://support.starshipit.com/articles/90200000000204-configure-shopify-order-import
Markdown: https://support.starshipit.com/articles/90200000000204-configure-shopify-order-import.md
Updated: 2026-09-03

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Set up and adjust how Starshipit imports orders from Shopify, including status filters, locations, delivery methods, tags, webhooks, and checkout-rates-only mode.

Starshipit's Shopify import settings control which orders come through, when they arrive, and what triggers a skip. All settings are found at **Settings > Integrations > Shopify Settings**.

Import settings are divided into the **main settings tab** and the **Advanced tab**. This article covers all import-related settings in both.

## Status filter

The status filter is the most common reason orders do not import. The setting name and available options differ between Classic and Enhanced.

### Classic: order status

Classic uses the Shopify **order status**. Only orders matching the selected status will import.

Available options:

| Option | When to use |
| --- | --- |
| Open | Orders that are placed and not yet fulfilled or closed. The most common choice. |
| Paid | Orders with payment completed. |
| Partially Refunded | Orders where part of the payment has been refunded. |
| Closed | Orders that have been archived or closed in Shopify. |
| Cancelled | Cancelled orders. Rarely used for import. |
| Any | All orders regardless of status. Use with caution. |

### Enhanced: financial status

Enhanced uses the Shopify **financial status** on the parent order. Fulfillment-order filters (location, delivery method) are applied after the financial status check.

Available options:

| Option | When to use |
| --- | --- |
| Paid | Orders that are fully paid. The most common choice. |
| Authorized | Payment authorised but not yet captured. |
| Pending | Payment pending (for example, bank transfers or cash on delivery). |
| Partially Paid | Partial payment received. |
| Partially Refunded | Order partially refunded. |
| Refunded | Order fully refunded. |
| Voided | Payment void. |
| Unpaid | Order placed without payment. |
| Any | All orders regardless of financial status. Use with caution. |

## Locations (Enhanced only)

The **Locations** filter controls which Shopify assigned fulfillment locations Starshipit imports from. The location refers to the Shopify fulfillment order's assigned location, not the Starshipit sender address.

- **All Locations** — Starshipit imports fulfillment orders from every location. This is the default.
- **Specific location** — Only fulfillment orders assigned to the selected Shopify location will import.

Use a specific location when you run multiple child Starshipit accounts, one per Shopify location. See [Shopify Enhanced: locations, delivery methods, and split fulfillment](/articles/integrations/shopify/shopify-enhanced-locations-delivery-split-fulfillment) for the full multi-location setup guide.

If the location list is empty or not loading, reauthorise the Shopify integration — this is usually a permissions issue.

## Delivery methods (Enhanced only)

The **Delivery Methods** filter controls which Shopify fulfillment order delivery types are imported.

| Option | What it imports |
| --- | --- |
| Shipping | Orders for home or business delivery. Selected by default. |
| Local Delivery | Orders where the customer is nearby and has opted for local delivery. |
| Local Pick Up | Orders the customer will collect in person. |

**Shipping** is selected by default. Add **Local Delivery** or **Local Pick Up** if you want those fulfillment orders imported.

:::note
Shopify does not always include delivery method data on every fulfillment order. Fulfillment orders without delivery method data are treated as **Shipping** by Starshipit. If known pickup orders keep importing when only Shipping is selected, use an import rule to exclude them by tag or shipping description.
:::

For more detail on pickup and split fulfillment behaviour, see [Shopify Enhanced: locations, delivery methods, and split fulfillment](/articles/integrations/shopify/shopify-enhanced-locations-delivery-split-fulfillment).

## Excluded tags

The **Exclude orders with these tags** field prevents orders with specific Shopify tags from importing. Enter one or more tags separated by semicolons. Tags are not case-sensitive.

This is the recommended way to manage pre-orders and back-orders:

1. In Starshipit, go to **Settings > Integrations > Shopify** and open the **Advanced** tab.
2. In the **Exclude orders with these tags** field, enter the tag you will use — for example, `preorder`.
3. In Shopify, add that tag to any order you want to hold back.
4. When you are ready to ship the order, remove the tag in Shopify. The order will import on the next import cycle.

## Fraud check

When fraud checking is enabled, Starshipit skips orders where Shopify's risk analysis recommends cancellation. The order is not imported.

To enable: go to **Settings > Integrations > Shopify > Advanced** and enable **Enable Fraud Check**.

If a legitimate order is being skipped by fraud checking, review the order's risk details in Shopify directly.

## Additional import criteria

The following options are in **Settings > Integrations > Shopify > Advanced**. Leave them at their defaults unless the description matches your workflow.

| Setting | What it does |
| --- | --- |
| **Disable the 500 order import limit** | Lets one import retrieve more than 500 orders. The limit keeps normal imports faster, so use this only when you need to import a larger backlog. |

## Map Shopify data to Starshipit fields

Use **Settings > Integrations > Shopify > Advanced > Field mapping** when your Shopify data needs to arrive in a particular Starshipit field. Enable only the options you need.

| Setting | What it does |
| --- | --- |
| **Import tags from Shopify** | Imports Shopify order tags so you can see them on the order and use them in Starshipit rules. |
| **Import country specific tax IDs** | Imports destination tax identifiers, such as CPF/CNPJ or RFC, for supported countries. |
| **Import country specific HS codes** | Uses the inventory item's destination-country HS code when one is available; otherwise Starshipit uses its generic HS code. |
| **Import DHL service point metafield** | Imports the `delivery.service_point_id` order metafield. Leave this off unless you use DHL service points. |
| **Use Shopify pickup location address for local pickup orders** | For Enhanced integrations, uses the assigned Shopify location address when a local-pickup order has no shipping address and Shopify provides complete location details. |
| **Import product dimensions metafields** | Imports dimensions from product or product-variant metafields. Use the matching entity and choose the unit for numeric values. Supported keys are `shipping_length`, `shipping_width`, and `shipping_height`, or `length`, `width`, and `height`. |
| **Import bin location metafield** | For Enhanced integrations, imports a bin location from the selected product or product-variant metafield. The metafield key must be `bin_location` and use a one-value, single-line-text definition. |
| **Map address line 2 into "Building" field** | Sends Shopify address line 2 to Starshipit's **Building** field instead of **Suburb**. |
| **Map order notes** | Choose whether Shopify order notes are not imported, go to delivery instructions, go to the notes section, or go to both. |
| **Import order number prefix and suffix** | Keeps Shopify's order-number prefix and suffix when importing the order number. |
| **Map the name of product variants for order item descriptions** | Uses the Shopify variant name as the item description instead of the product title. |
| **Import shipping as a line item** | Adds the amount paid for shipping as a `Shipping` line item on the imported order. |
| **Import item quantity instead of fulfillable quantity** | Imports the ordered quantity rather than the fulfillable quantity. This can include deleted items, so it is not normally recommended. |
| **Import item properties as line items (multi-buy bundles)** | For Classic integrations, turns properties saved on one bundle line item into separate imported line items. |
| **Expand bundle products on import** | Expands bundle products into their individual items based on the bundle SKU. |
| **Consolidate shipping methods** | Combines all Shopify shipping-line titles into one value and writes it to the Starshipit shipping-method field. |

## Webhooks

Webhooks allow Shopify to push order updates to Starshipit in near real time, rather than waiting for the scheduled import cycle (which runs approximately every 20 minutes).

To subscribe:

1. Go to **Settings > Integrations > Shopify Settings**.
2. Scroll to the bottom of the page and click **Subscribe to webhook**.

When a webhook is active, eligible Shopify order updates arrive in Starshipit within seconds of being created or updated.

If the webhook subscription fails:

- Save your Shopify settings first, then try subscribing again.
- If the subscription still fails, reauthorise the Shopify integration and try once more.

:::note
Webhooks require a saved Shopify integration. Switching between Classic and Enhanced may replace the webhook subscription — resave and resubscribe after any version change.
:::

## Checkout-rates-only mode

Enable **Use for checkout rates only** when this Shopify integration should return shipping rates at Shopify checkout but should not import orders.

When this setting is on:

- Starshipit will not import any orders through this integration.
- Shopify checkout rates continue to work normally.
- This is useful when orders are imported through a different system, such as a warehouse or inventory management platform.

See [Shopify: Rates at checkout](/articles/rates-at-checkout/platform-specific-guides/shopify-rates-at-checkout) for the checkout rate setup guide.