Shopify guide

Reconcile inventory for a linked Shopify product

Inventory reads and writes require a current product link, a tracked variant, a mapped location, and the scopes for the action.

Shopify-confirmed values and seller-managed values stay separate until you explicitly apply one side. Inventory actions are tied to a product linked to the currently connected Shopify store.

  1. 01

    Open a profile linked to the connected store

    Find the item in Inventory and open its profile. The inventory panel only works for a Shopify product linked to the store currently connected in Shopify management. If the profile is unlinked, create or verify its product link first.

  2. 02

    Map the tracked variant and inventory location

    The linked product must resolve to the correct Shopify variant, and that variant must track inventory. It must also resolve to the location whose quantity you intend to reconcile. If there are multiple variants or stocked locations, choose the correct one in the panel. Missing or ambiguous mappings, an untracked variant, and a location with no inventory level prevent a current quantity check.

  3. 03

    Refresh to record an observation

    Refresh reads Shopify’s available status and quantity for the mapped variant and location. It records an observation and shows whether values match, but does not change Shopify or the RummageRail profile. A saved older reading is historical until a fresh check verifies it.

  4. 04

    Apply Shopify values to the seller profile

    When the current Shopify values differ, choose Apply Shopify to RummageRail to update the seller-managed availability and quantity from the confirmed observation. Review the resulting verification state; the panel keeps Shopify values and seller values labeled separately.

  5. 05

    Apply seller-managed values to Shopify

    Choose Apply RummageRail to Shopify only after reviewing the target variant, location, and seller values. Reading needs read_products and read_inventory. Writing quantity also needs write_inventory. Changing Available or Not available additionally changes Shopify product status and needs write_products. RummageRail reads back the result; if it cannot confirm the values, treat the write as unverified and check again before retrying.

  6. 06

    Handle Reserved and mapping warnings

    Reserved has no Shopify availability equivalent, so RummageRail sends quantity only and leaves Shopify availability unchanged. If the panel reports a missing or ambiguous mapping, choose a variant or location. If inventory is not tracked or the selected location has no level, correct tracking or stocking in Shopify, then refresh again.

Before you finish

  • Confirm the product link belongs to the connected store.
  • Confirm the tracked variant and the exact location before reconciling a quantity.
  • Refresh to observe; choose an apply action only after reviewing both labeled values.
  • Use the returned verification state; old readings and writes without a confirming read-back are not current verification.
Back to Help directory