Articles on: Frequently Asked Questions (FAQ)

How to Troubleshoot Common Product Feed Syncing Issues

If your product feed is not syncing as expected, the cause is usually one of the common issues below. Each issue includes the fix that resolves it in most cases.



Common Feed Syncing Issues & Fixes


1. No Matches Found


If your feed runs but shows zero matches:


  • Check the header row: If the headers start on a later row, adjust Skip Row in Feed → Edit Settings → Step 1.
  • Check filters: Make sure no filters are blocking items unintentionally.
  • Check identifiers: Confirm that the SKUs or product identifiers in the file match those in your store.


2. Incorrect File Path (FTP)


When using FTP, the file path must be exact. If the system reports the file as missing but you can download it manually:


  • Verify the folder name and file path.
  • Update the path in the feed settings if needed.


3. Filters Preventing Sync


Filters can unintentionally block products. Turn off enabled filters for a moment to test whether they are the cause.


4. Slow Sync or Stuck Sync


If your sync is unusually slow or stuck at a low percentage:


  • AI Description: Check whether AI Description or other AI-generated SEO settings are enabled. Each product needs an API call, so these settings can slow processing. Turn them off if you need faster updates.
  • Processing queue: If the feed freezes at a fixed percentage (for example, 14%) and shows 0 updates, there may be a temporary system delay or queue backlog. Run the feed again after a short wait.
  • Variant limit: If many scheduled feeds do not run, check that your variant limit has not been exceeded, since feeds pause when the limit is reached.
  • Large feeds: Very large feeds can queue longer during peak processing times.


5. Header or Formatting Issues


Formatting issues in your source file can prevent matching or updates.


  • Make sure the header row is correct.
  • Make sure the column separator matches the file format.


6. Unauthorized or Invalid API Credentials


If your feed uses an API and fails to sync:


  • Verify the username, password, token, or key with your supplier.
  • Tokens can expire, so refresh them if necessary.


7. Folder or File Structure Issues in Supplier Sources


Some suppliers provide files inside subfolders or ZIP archives. Stock Sync cannot extract ZIP files directly. Download and extract the data first, then upload or host the resulting CSV.


8. Store Filters Blocking Matches


Store-level filters can prevent matching results. Turn off store filters, run the feed, then turn them back on if needed.


9. Matching Column Issues


Incorrect matching column mapping can prevent updates. Make sure you are matching with the correct identifier, such as SKU or Handle.


10. Pagination Issues in API Feeds


If your API feed returns only part of the catalog, such as only the first page of results:


  • Check whether the supplier API requires pagination parameters such as page or limit.
  • Make sure pagination is enabled and configured correctly in the feed settings.
  • If you are unsure, ask the supplier for the API documentation.


11. Errors from Supplier Image Servers


If product creation fails with messages such as "Internal Server Error" during image download:


  • The supplier's image host may be temporarily down. These issues usually resolve once the server is stable.
  • Run the feed again after confirming that the image URLs load in a browser.


12. Confirming a Feed Setup with a Sample SKU


When a product does not update, first confirm that the feed uses the expected source, supplier or vendor filter, and fields. Review the feed settings and mapping, then check whether the sample SKU appears in the downloaded feed file.


  • If the SKU is not in the feed file, Stock Sync cannot match or update it. Confirm the SKU and product availability with your supplier.
  • For API feeds, compare the configured connection and response with the supplier's API documentation.
  • When you request an investigation, include the feed name and one sample SKU.


To verify a correction, run a test process and review the change log. If the result is as expected, click Start process to perform the actual update.


13. Automation Frequency Limitations


If updates run less often than expected:


  • The minimum automated sync frequency is once every hour.
  • For more frequent updates, run a manual sync at any time.



Key Rules & Technical Details


  • Minimum schedule: Automated syncs run at most once every hour.
  • Sample SKU: Support needs the feed name and one sample SKU to investigate an issue.



Troubleshooting Steps


  • Issue: The feed shows zero matches → Solution: Check the header row, filters, and whether the SKUs match your store.
  • Issue: The sync is stuck or very slow → Solution: Turn off AI Description if enabled, check the variant limit, and run the feed again after a short wait.
  • Issue: Products do not update → Solution: Confirm the sample SKU is in the feed file, then run a test process and review the change log.



Good Articles to Continue


Updated on: 16/11/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!