FAQ

Getting started

Do I need WooCommerce Marketplace to use this?

Yes. The connector is an add-on for WooCommerce Marketplace by Webkul and will not activate without it. The seller menu entry needs Marketplace 5.2.0 or newer, and the administrator's account list needs a version newer than 5.3.0.

Where does the seller find the connector?

My Account → Shopify Connector. It is a seller tool and does not appear in the WordPress admin menu — administrators get their own read-only screen at Marketplace → MP Shopify Connector.

Can the administrator connect a store for a seller?

No. Connections are made from the seller's own My Account area, because the Shopify credentials belong to the seller's store. An administrator who also holds a seller account can work with their own store normally.

Can a seller connect more than one Shopify store?

Yes. Each connected store is a separate account with its own settings, category mappings and price rules. Switch between them from the store pill at the top of the connector, or from the navigation panel.

Can two sellers connect the same Shopify store?

No. The connector matches on the store domain and refuses a second connection with "Account already exists. This Shopify store is already connected to another account."

Connecting

Which authentication method should I use?

Dev Dashboard App (OAuth). Shopify stopped allowing new legacy custom apps on 1 January 2026. The Legacy Custom App option remains for stores that already have one.

What is the difference between the Setup URI and the Main URI?

They are the two addresses Shopify may return the seller to — one for the setup wizard, one for the Add Account screen. Register both in the Shopify app's allowed redirection URLs, or whichever route the seller happens to take may fail.

Why does it insist the store name matches exactly?

Because that is the check that stops a seller attaching the wrong Shopify store. After authenticating, the connector reads the store's name back from Shopify and compares it. Copy the name from Settings → Store details in the Shopify admin.

Do I enter the domain with https://?

No. Enter my-store.myshopify.com. In the setup wizard, a bare handle such as my-store is expanded automatically.

What is the API Secret Key used for?

Verifying incoming Shopify webhooks. Without the right value, the store connects and the webhooks appear healthy, but every live update is rejected.

Products

Which product types are supported?

Simple and variable products, in both directions. A variable product exports with each variation as a Shopify variant.

What comes across when a product is imported?

Name, description, price, SKU, stock quantity, weight, the base image, all additional images, and for variable products every option and its values.

Why is importing split into two buttons?

So a large catalogue does not have to be fetched and built in one request. Import Product stages the data from Shopify; Create Imported Products builds the WooCommerce products from it. Each runs in batches with a progress bar.

Can I import only part of the Shopify catalogue?

Yes, two ways. Set Products to Import to Only mapped categories product and map only the collections you want. Or use Products to Import having Shopify Status to take only Active, Archived or Draft products.

What does Refresh Imported Products do?

It re-pulls only inventory and prices for every imported product. Use it when stock or pricing has drifted across many products at once; for one or two products, Update from Shopify on the selected rows is faster.

How do I stop an update overwriting my Shopify descriptions and photos?

Use Product Fields To Update on the Settings tab and select only Price and Quantity. Only the chosen fields are written.

Why do imported products have no images?

Product Image Import is probably set to In The Background. Products are created first and images fill in behind them; the Product images left for create counter shows the backlog. Setting it to During Product Import creates them inline instead.

Why will my variable product not export?

Shopify allows a maximum of three options per product. A WooCommerce product with four or more variation attributes cannot be created on Shopify. Reduce it to three or fewer and try again.

Which product types can be exported?

Only simple and variable products. Grouped and external/affiliate products are never listed on the Export Product tab.

Where do I get the Shopify API credentials?

For a Dev Dashboard app: the Client ID and Client Secret from the app's credentials screen at dev.shopify.com. For a legacy custom app: Apps → Develop apps for your store → Create an app → Configuration → Admin API integration, grant the permissions, then Install app and Reveal token once. Full walkthrough in Creating the Shopify App.

I lost the Admin API access token. Can I see it again?

No. Shopify shows it once. Uninstall and reinstall the app to generate a new one, then paste it on the Account tab.

Does deleting a product in WooCommerce delete it on Shopify?

No. Deleting removes the WooCommerce product and clears the connector's mapping. Remove the Shopify copy from the Shopify admin if you no longer want it listed.

Orders

Do the products have to be exported before I can export an order?

They have to be linked to the Shopify account — which is true if they were either imported from Shopify or exported to it. Either one counts.

Do I have to import products before importing orders?

Yes. An order is a list of products, and WooCommerce cannot record an order for a product it does not have. Without them the connector reports "Order not Created due to product unavailabilty so please import products."

What status do imported orders get?

Whatever you set as Import Orders As on the Settings tab. Every imported order is created with that status.

Can orders be exported to Shopify automatically?

Yes. Set Shopify Export Order to All, or to a specific WooCommerce order status. Matching orders are created on Shopify as soon as the buyer finishes checkout. Manual switches this off.

Which order status should trigger an automatic export?

Processing is the usual choice — the order is paid, so it is worth reserving stock on Shopify, but it has not shipped. All exports even unpaid orders.

Does exporting an order reduce Shopify stock?

Yes. Orders are created with an inventory behaviour that decrements stock while obeying the product's own Shopify stock policy, so Shopify's oversell rules still apply.

Will the buyer see the Shopify tracking number?

Yes, for orders the connector knows about. When the seller fulfils in Shopify, the ORDERS_FULFILLED webhook writes the Tracking Company, Tracking Number and Tracking URL onto the WooCommerce order lines.

Where does the administrator see which orders are linked?

The Shopify Order Id column on WooCommerce → Orders.

Pricing

Do price rules change the price in the source store?

No. A rule only affects the copy created in the destination store. The source catalogue is untouched.

Why is my price rule not applying?

Check four things: Price Rule Applicable For is not None; the rule is Enabled; the product's price is inside the rule's band; and the rule belongs to the store you are syncing.

Will a rule re-price products I have already synced?

No. Rules apply as a product crosses. Run an update or a re-import for a new rule to take effect on existing products.

Can a rule make a product free?

No. If an adjustment would leave the price at zero or below, the original price is kept.

Sync and webhooks

How many webhooks does the connector create?

Three per connected store: PRODUCTS_UPDATE, PRODUCTS_DELETE and ORDERS_FULFILLED. They are registered automatically when the store is connected.

The webhooks are listed but nothing is syncing. Why?

Almost always because Product Auto-Sync is not set to Shopify To WooCommerce. Product webhooks are received and verified but not applied unless that direction is selected.

Can I sync in both directions at once?

No, and deliberately. Product Auto-Sync takes one direction — Shopify to WooCommerce, or WooCommerce to Shopify — so the two systems cannot end up correcting each other in a loop.

What does "N Realtime Sync Notification Pending in background" mean?

Shopify has sent updates that are queued and waiting to be applied. A background process drains the queue. A count that never falls means WordPress's scheduler is not running.

Data and removal

What happens when a Shopify account is deleted?

The connection is removed along with the connector's product and order mappings, category mappings, price rules and settings for that store. Products and orders already imported into WooCommerce stay — but they are no longer linked, so reconnecting the same store imports them again as new items.