Troubleshooting

Every entry here is a message or behaviour the connector actually produces. Find the symptom, confirm the cause, then work through the fix.

The Shopify Connector menu is missing

Symptom — a seller signs in, opens My Account, and there is no Shopify Connector entry.

Check, in this order:

1. Is the plugin active? Plugins → Installed Plugins should show WooCommerce Marketplace Shopify Connector as active.
2. Is WooCommerce Marketplace active, and recent enough? The menu entry is only registered on Marketplace 5.2.0 or newer. On an older version the connector runs but the seller has no way in.
3. Is the user actually a seller? The connector checks marketplace seller status on every screen. A customer account, or a seller whose application has not been approved, never sees it.

The connector page returns "page not found"

Cause — WordPress has not registered the connector's two new My Account endpoints, shopify-connector and shopify-setup.

Fix — go to Settings → Permalinks and select Save Changes. Nothing needs to change on that screen; saving refreshes the rewrite rules. Reload the seller's My Account page.

"Please Enter All Required Details."

Cause — a required field on the Add Account form or the setup wizard was left blank.

Fix — complete every field marked with a red asterisk. For an OAuth connection that is Store Name, Domain Name, App Client ID and App Secret Key; for a legacy connection it is Store Name, API Token, Domain Name and API Secret Key.

"Added store name does not match with the shopify store name."

Cause — after authenticating, the connector reads the store's name back from Shopify and compares it with the Store Name you typed. They differ.

This check exists to stop a seller attaching the wrong store. It is deliberately strict.

Fix — open the Shopify admin, go to Settings → Store details, and copy the store name exactly as it appears there, including capitals and spacing. Paste it into Store Name and try again.

"Please Enter Your Correct Shopify Account Details."

Cause — Shopify rejected the credentials.

Fix:

• OAuth — re-copy the Client ID and Client Secret from the Developer Dashboard app. It is easy to copy a trailing space or to paste one app's secret alongside another's ID.
• Legacy — re-copy the Admin API access token. It begins with shpat_. Tokens are revoked when the custom app is uninstalled or its scopes are changed.

"Account already exists."

Cause — this Shopify store is already connected, either to this seller or to another one. The connector matches on the store domain and on the app client ID.

Fix — if it is the seller's own store, manage the existing account rather than adding it again. If another seller connected it, the connector reports "Account already exists. This Shopify store is already connected to another account." — one Shopify store belongs to one seller.

"Invalid OAuth state"

Cause — the authorisation round trip did not complete cleanly. The value the connector generated before sending the seller to Shopify did not come back. Usually this means the browser session changed mid-flow, the popup was reused from an earlier attempt, or the seller opened the callback URL by hand.

Fix — close any leftover Shopify authorisation window and start again from Add Account. If it keeps happening, confirm both redirect URIs are registered in the Shopify app exactly as the connector prints them.

"Sorry, but you can not access other sellers' account..!"

Cause — the account ID in the URL belongs to a different seller.

Fix — go back to Shopify Connector and open the account from the list rather than editing the address bar. This is a permission check, not a fault.

"Category already mapped."

Cause — that WooCommerce category is already paired with a Shopify collection. Each category can be paired once.

Fix — delete the existing pair from the mapped list first, then create the new one. Note that the picker hides already-mapped categories, so seeing this message usually means the mapping was created in another browser tab.

"There are no products available to create."

Cause — you selected Create Imported Products but nothing is staged.

Fix — run Import Product first. The import stages the data; the create step turns it into WooCommerce products. If you have already created everything that was staged, this message is simply telling you there is nothing left to do.

"Product(s) skipped due to category not mapped"

Cause — the account's Products to Import setting is Only mapped categories product, and these products belong to Shopify collections that are not paired with a WooCommerce category.

Fix — either map the missing collections on the Map Categories tab, or change Products to Import to All products on the Settings tab and set a Default Category.

"Order not Created due to product unavailabilty so please import products."

Cause — a Shopify order references products that do not exist in WooCommerce. An order cannot be created without its line items.

Fix — run Importing Products through both stages, then run Create Imported Orders again. The staged orders are still there.

"Selected order product(s) are not available on Shopify."

Cause — one or more line items on that order are not linked to this Shopify account. A product counts as linked if it was imported from Shopify or exported to it; this message means at least one item is neither.

Fix — go to the Export Product tab, export the products in that order, then export the order. Rows in this state are labelled Products Not Exported in the Export Status column, so you can see which orders are blocked before you try.

A variable product will not export

Cause — Shopify allows a maximum of three options per product. A WooCommerce product with four or more variation attributes cannot be created on Shopify.

Fix — reduce the product to three variation attributes or fewer, then export it again. There is no warning before you try; the failure comes back from Shopify.

A product is missing from the Export Product list

The list deliberately hides several things. A product will not appear if it:

• is not a simple or variable product — grouped and external/affiliate products are excluded;
• was imported from this Shopify store, so it is already linked;
• has already been exported to this account; or
• belongs to a different seller.

Shopify rejects the connection after the app worked before

Cause — the app's scopes were changed, or the app was uninstalled and reinstalled. Both invalidate the existing Admin API access token.

Fix — generate a new token (Apps → Develop apps → your app → API credentials) and paste it on the Account tab, or for a Dev Dashboard app select Refresh the app details. See Creating the Shopify App.

An account shows "Disconnected"

The status is checked live: the connector asks Shopify for the store's name and compares it with the saved one.

Common causes:

Live updates from Shopify are not arriving

Work through these four in order — they are the four things that must all be true.

1. Are the webhooks registered? Open the Webhooks tab. You should see all three: ORDERS_FULFILLED, PRODUCTS_UPDATE and PRODUCTS_DELETE. If any is missing, select Generate Webhooks.
2. Is Product Auto-Sync set correctly? Product webhooks are only applied when Product Auto-Sync is Shopify To WooCommerce. This is the single most common cause — the webhooks look perfectly healthy while the sync is switched off.
3. Is the API Secret Key right? Every incoming webhook is signature-checked against it. A wrong key means every update is rejected with a 403, silently from the seller's point of view. Check WooCommerce → Status → Logs, source MP Shopify Connector Shopify To Woo Sync Notification, for "Webhook Verification failed".
4. Is the background queue moving? The admin page shows "N Realtime Sync Notification Pending in background." A count that never falls means WP-Cron is not running. The connector restarts a queue that has stalled for five minutes, but it cannot run at all if WordPress's scheduler is disabled.

Imported products have no images

Cause — Product Image Import is set to In The Background, and the image queue has not drained yet.

Fix — the Product images left for create counter on the Import Product tab shows how many are outstanding. It falls as the background process works. If it does not move, WP-Cron is not running — the same cause as a stuck notification queue.

Setting Product Image Import to During Product Import creates images inline instead. That is slower during the import but leaves nothing queued.

Prices are not being adjusted

Check:

1. Price Rule Applicable For on the Settings tab is Import Product or Export Product — not None.
2. The rule's Status is Enabled.
3. The product's price falls inside the rule's Price From – Price To band.
4. The rule belongs to the Shopify Store you are syncing.

Also remember that price rules apply as a product crosses. Adding a rule does not re-price products that are already synced — run an update or re-import for it to take effect.

If an adjustment would take a price to zero or below, the connector keeps the original price on purpose.

An import stops part way

Large catalogues import in batches, and the batching runs in the browser tab.

Fix — select the same action again. Already-imported products and orders are recognised and counted as Already Imported, so restarting is safe and picks up where it stopped. Keep the tab open and the screen awake for a long run.

Still stuck?

Collect this before raising a ticket — it saves a round trip:

• the plugin version (3.0.0), WooCommerce version and WooCommerce Marketplace version;
• the exact message shown on screen;
• the tab and action that produced it;
• the relevant entries from WooCommerce → Status → Logs (sources WCMP-Shopify and MP Shopify Connector Shopify To Woo Sync Notification).

Raise a ticket at webkul.com/ticket.

Never send credentials in a ticket. Support never needs the Client Secret or the access token.