> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.stock-sync.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Troubleshooting Stock Feed Update Issues in syncX: Stock Sync

This guide covers the most common reasons stock feed updates fail in syncX: Stock Sync, along with the steps you can take to diagnose and resolve issues.

## Verify You Are Using the Correct Feed Type
* Use an **Update feed** when you want to update existing products or variants (for example, updating stock quantity).
* Use an **Add feed** to import **new** products into your store.

If you use an Update feed but your store does not yet contain the products, you may see messages like **"Store is empty"**.

## Ensure Required Fields Are Mapped
For Update feeds, at a minimum, you need to map: 
* SKU
* Quantity

If the file lacks required fields for Add feeds (such as Product Title or Price), the feed cannot import new products. Verify that your supplier’s file includes these fields.

## Test Run the Feed
Use the **Test Run** feature to quickly confirm whether:
* The feed URL is accessible
* The system can read your file
* The field mapping is correct

## Check Whether the Feed Is Actually Updating
If a feed appears to return no matches or you believe it is not running:
* Go to **Recent Activity Logs** to confirm when the feed last updated and how many variants were processed.
* Even if a file preview does not display as expected, the activity logs may show that the feed is updating products correctly.

## Verify the File or Source URL
If a feed shows 0 matches or the file cannot be read:
* Confirm the file exists at the URL
* Check that the file name and path are correct
* Ensure the file is accessible without login requirements
* If apply any filters, check that the filters are correct

## Other Reasons You May See "0 Products Added"
* Using an **Update feed** when the products do not yet exist in the store. Use an **Add feed** for initial imports.
* A **Quantity Zero Alert threshold** blocking updates (for example, more than 80% of items in the file have quantity 0).
* **Low credit status** when importing with an Add feed. Note: the "Only process 3 products" test run bypasses credit usage, but full imports still require sufficient credits.
* Incorrect field mapping (e.g., missing SKU or key identifier).

## Additional Reasons a Feed May Get Stuck Processing
Feeds may appear stuck in "Processing" due to:
* The feed name
* The feed URL
* A description of which part is not working

## Additional Notes on Unmatched or Missing Updates
* If SKUs do not match between your file and your store, those items will not update. Ensure the SKU exists in both places.
* If you only run a **Preview Sync**, no actual updates will occur. You must run the full process to apply changes.
* Filters such as product tags may exclude certain items. If a product does not meet the filter conditions, it will not update.
* Invalid source credentials (for example, FTP username or password) will prevent the feed from running.

## When to Contact Support
If you see unexpected errors, missing updates, or cannot determine which part of the process is failing, contact support with:
* The feed name
* The feed URL
* A description of which part is not working
* A **sample SKU** that is not updating (for example, stock not changing to 0)

Providing a sample SKU helps us troubleshoot issues such as filters not applying or quantities not updating. This helps us identify the cause quickly and provide guidance.