FAQ & Notes
Answers to the questions that come up most often, based on how the connector actually behaves.
Connecting
Which app type should I use — Dev Dashboard or Legacy?
Use a Developer Dashboard app (OAuth). Shopify discontinued support for creating new legacy custom apps on 1 January 2026. Existing legacy apps keep working, so there is no urgency to migrate a store that is already connected.
Why is my connection refused with a store-name error?
The Store Name you enter must match the store name on Shopify. If it does not, you will see Added store name does not match with the shopify store name. Copy the name exactly as Shopify shows it.
I get "OAuth Authentication Failed" even though my keys are right.
Check the redirect URIs. Both URIs shown on the credentials step must be added to your Shopify app under Settings → Allowed Redirection URLs, exactly as given. Use Copy Setup URI and Copy Main URI rather than typing them.
It says I connected, but reading the store details failed.
The credentials worked but the app could not read your shop. This means the app is missing the scopes it needs, or the app version has not been released. Fix both in the Shopify Developer Dashboard, then use Refresh the app details on the Account tab.
I released a new version of my app and things stopped working.
Open Manage Account → Account and select Refresh the app details. The connector keeps using the previous app version until you do.
Can one vendor connect more than one Shopify store?
Yes, with no fixed limit. Each store keeps its own settings, category mappings, price rules and webhooks. Switch between them using the store pill at the top right of Manage Account.
Products
Why is a product missing from the Export Product list?
Products imported from Shopify are excluded from the export list on purpose, so you cannot push a product back to the store it came from. If the product came in through an import, that is expected.
Why did my products import without images?
Check Product Image Import in General Settings. If it is set to In The Background, products are created first and images follow — the screen tells you how many are still to come. Images also need outbound access to Shopify's CDN, so a server that blocks external requests will import products without pictures.
Only some of my Shopify products imported.
Two settings decide what is included:
- Products to Import — if set to Only mapped categories product, only mapped collections are imported.
- Products to Import having Shopify Status — if set to Active, archived and draft products are skipped.
How do I refresh one product without re-importing everything?
Use Update From Shopify on that product's row in the import list.
What happens if I delete an imported product from the list?
Only the link is removed. The confirmation says so explicitly: "This only removes the connection here. The product itself is not deleted from Shopify." The product stops syncing.
Orders
Why is my Export Order list empty?
It only lists orders that contain this vendor's products. A brand-new store with no sales yet will show No Data Found.
How do I export an order? I cannot find a button on the row.
Export is a bulk action. Tick the order, choose Export under Bulk actions, then select Apply. The only control on the row itself is View.
Can orders go to Shopify automatically?
Yes. Set Shopify Export Order in General Settings to Realtime, or to a specific order status. Choosing a status is usually better — it avoids sending orders that are later cancelled or never paid.
What status will imported orders have?
Whatever you set in Import Orders As. If you leave it unset, imported orders fall back to the WooCommerce default rather than a status you chose, so set it before your first import.
Prices
My price rules are not doing anything.
Check Price Rule Applicable For in General Settings. If it is None, rules are ignored no matter how many you have created. Set it to Import Product or Export Product.
Can I have different margins for cheap and expensive products?
Yes — that is what the bands are for. Create one rule per price range, each with its own percentage or fixed adjustment. Keep the bands from overlapping so it is always clear which rule applies.
How do I turn a rule off without losing it?
Tick it, choose Disable under Bulk Actions and select Apply. Deleting is permanent and is only available as a bulk action.
Synchronisation
Nothing updates automatically.
Real-time behaviour needs webhooks. Open Settings → Webhooks; if the list is empty, select Generate Webhooks. Then check the relevant setting under Shopify Auto-Syncing Settings is not Disable or Manual.
I cannot see the Generate Webhooks button.
It only appears when webhooks are missing. Once three or more are registered it is hidden, because there is nothing left to create.
Changes in WooCommerce are not reaching Shopify.
Product Auto-Sync runs in one direction only. If it is set to Shopify to WooCommerce, edits made in the vendor dashboard will not be pushed out. Switch it to WooCommerce to Shopify if that is what you need.
Is it safe to press Generate Webhooks more than once?
Yes. Existing subscriptions are never duplicated — if everything is already registered you simply see All webhooks are already created.
Administration
How do I tell which vendors have working connections?
Open Webkul WC Addons → WCFM Shopify Connector. The Status column shows whether the connection works, and Webhooks Generated shows whether real-time sync is set up.
Can I import or export on a vendor's behalf?
No. The admin screen is for oversight. All operations run under the vendor's own Shopify credentials, in their own dashboard.
What happens when I delete a vendor's account?
The connection is removed and syncing stops. Their Shopify store is not affected, but they will need their app credentials to reconnect — so tell them first.
Notes and limitations
- WCFM Marketplace is required. Every vendor screen is a WCFM dashboard page. Without WCFM, vendors cannot reach the connector at all.
- Settings are per Shopify account, not per vendor. A vendor with two stores configures each separately.
- Product Auto-Sync is one direction at a time, by design.
- Manual import and export always work, even when webhooks are missing or auto-sync is off.
- The connector needs outbound HTTPS to Shopify and to Shopify's CDN for product images.
Getting help
If something is not covered here, raise a ticket with Webkul Support. Include your plugin version (3.0.0), whether you connected with a Dev Dashboard or legacy app, and the exact message you saw.