# Import optional data from Shopify
URL: https://support.starshipit.com/articles/90200000000206-import-optional-data-from-shopify
Canonical: https://support.starshipit.com/articles/90200000000206-import-optional-data-from-shopify
Markdown: https://support.starshipit.com/articles/90200000000206-import-optional-data-from-shopify.md
Updated: 2026-05-27

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

> Configure which additional data Starshipit imports from Shopify, including tags, order notes, shipping line items, metafields, and bundles.

Starshipit can import extra data alongside your Shopify orders. All optional import settings are found under **Settings > Integrations > Shopify > Advanced tab > Field Mapping section**, unless otherwise noted.

## Tags

Enable **Import Tags from Shopify** to bring Shopify order tags into Starshipit. Once imported, tags appear in the orders grid.

For more on using tags in Starshipit, see [Tags](/articles/orders-manifests-reports/orders/tags).

## Order notes

Choose how Shopify checkout notes are mapped when they import into Starshipit. Select from the **Map order notes** dropdown:

| Option | What it does |
| --- | --- |
| Do not import notes | Notes are discarded on import. |
| Map to delivery instructions | Notes appear in the Delivery Instructions field. Use this when notes contain delivery-specific information. |
| Map to notes section | Notes appear in the Notes field. Use this for personalisation, gift messages, or other non-delivery notes. |
| Map to both | Notes appear in both fields. |

:::note
The Notes section is available in UI 2.0 only.
:::

## Shipping as a line item

Enable **Import shipping as a line item** to add the Shopify shipping charge as a line item named `Shipping` on each imported order.

When a Shopify Enhanced order is split into multiple Starshipit shipments, the shipping cost is proportionally allocated across each shipment based on item value.

**Example:** A customer pays $10 shipping. The order splits into two fulfillments: one worth $50 and one worth $150. The $50 shipment gets $2.50 in shipping; the $150 shipment gets $7.50.

This can help when a carrier or customs workflow needs the freight charge from Shopify included as an order line, such as DHL shipments where the commercial invoice needs to show the shipping charge. If Shopify applied free shipping, a discount, or a minimum shipping charge, Starshipit imports the final shipping amount supplied by Shopify.

## Item quantity vs fulfillable quantity

By default, Starshipit imports the **fulfillable quantity** of each line item — the quantity Shopify considers ready to fulfill. This is the safer default, especially in Enhanced where items can be split across fulfillment orders.

Enable **Import item quantity instead of fulfillable quantity** if you need the total ordered quantity regardless of fulfillment state. Only use this if you are certain it matches your workflow.

## Bin location metafield

Starshipit can import bin location data from a Shopify product or product variant metafield to help with pick and pack.

**Setup in Shopify:**

1. Create a [new custom text metafield](https://help.shopify.com/en/manual/metafields/metafield-definitions/creating-custom-metafield-definitions) in Shopify.
2. Set the namespace and key to:
   ```
   custom.bin_location
   ```
3. Add values to each relevant product or variant.

**Setup in Starshipit:**

1. Go to **Settings > Integrations > Shopify > Advanced**.
2. Enable **Import Bin Location metafield**.
3. Select whether the metafield is on the **product** or the **variant**.
4. Click **Save**.

Bin locations will appear on imported orders.

## Customs item descriptions

Starshipit can import customs item descriptions from a Shopify product custom field. This is useful for international shipments.

**Setup in Shopify:**

1. Create a custom field on the product using the namespace and key:
   ```
   custom.customs_description
   ```
2. Add a value to each relevant product.

No additional setup is required in Starshipit. The customs description imports automatically when those products are included in a shipment.

## Country-specific tax IDs

Enable this setting to import destination tax identifiers from Shopify's localized order fields — for example, CPF/CNPJ for Brazil or RFC for Mexico. Starshipit uses these on international shipments where required.

## Country-specific HS codes

When enabled, Starshipit prefers country-specific HS codes from Shopify inventory item data, if available. If a country-specific code is not found, it falls back to the generic HS code on the product.

## DHL service point metafield

Enable this setting to import the DHL service point ID from the `delivery.service_point_id` metafield on the Shopify order. This setting triggers an additional Shopify API call per order.

Only enable this if you use DHL with service point delivery. Do not enable it for general use.

## Product variants as item descriptions

Enable **Map the name of product variants for order item descriptions** to use Shopify variant names as the line item description in Starshipit. This is useful for pick and pack when your products have multiple variants (size, colour, etc.).

Changes apply to newly imported orders. To update existing orders, remove and re-import them.

## Bundle products

Shopify bundle products are typically imported as a single line item with item properties listing the individual components. To split bundles into separate line items:

1. Go to **Settings > Integrations > Shopify > Advanced > Field Mapping**.
2. Enable **Expand bundle products on import**.

**Shopify bundle apps:** Starshipit supports most common Shopify bundling apps, including the native [Shopify Bundles](https://apps.shopify.com/shopify-bundles) app. Bundle configurations vary between apps, so test compatibility with your specific app before relying on it in production.

## Product Catalogue and Shopify

Shopify sends Starshipit the order and product data available on the imported order, such as SKU, title or item name, variant details, barcode, weight, and available customs fields such as HS code or country of origin.

The Starshipit [Product Catalogue](/articles/integrations/product-catalogue/product-catalogue) can enrich imported Shopify orders when the SKU on the order item matches a SKU in the catalogue. Depending on your Product Catalogue settings, Starshipit can fill or improve values such as:

- Package matching
- Customs fields
- Bin location
- Missing or corrected weights
- Checkout-rate package selection

The Product Catalogue is especially useful for Shopify checkout rates because Shopify live-rate requests are weight-first. When Starshipit can match cart items to catalogue products, it can use your saved catalogue data before returning rates to Shopify.