Articles on: Frequently Asked Questions (FAQ)

Email Feed Troubleshooting

Resolve common issues when Stock Sync does not receive or process your supplier emails, attachments, or download links. Follow this checklist to verify email forwarding, whitelist sender addresses, inspect attachment formats, and resolve delivery failures.

How to Check Your Email Feed Configuration

Go to App → Feed Settings → Step 1: Feed Manager

Verify Feed Email Address: Locate the unique Stock Sync recipient email generated for your feed in Step 1.
Confirm Connection Method: Verify whether your source is set to Email with Attachment or Email with URL.
Check File Format: Ensure the expected file format (e.g., .xlsx, .csv) matches your supplier's attachment.

Always trigger a manual email test after modifying connection settings to verify delivery.

Email Troubleshooting Checklist / Detailed Breakdown

1. Verify the Feed Email Address

Ensure the sender or automated system sends messages to the exact, unique email address assigned to your Stock Sync feed.

Each feed has a unique destination address; do not send files intended for an Update feed to an Add feed address.

2. Check Email Forwarding Settings

If using Gmail, Microsoft Outlook, or another email client to forward supplier emails automatically, ensure forwarding rules are active and verified.

For Gmail auto-forwarding, refer to the Gmail Auto-Forward Confirmation Guide to retrieve your verification code.

3. Review Spam Folders and Subject Filters

Check that emails sent to Stock Sync are not blocked by external mail filters.

Verify that your forwarding inbox did not route the message into a Spam or Junk folder.
If your feed uses a Subject Filter, ensure the incoming email's subject line matches the configured keyword condition exactly.

4. Confirm Approved Senders (Sender Whitelist)

If your feed is configured with sender restrictions, verify that the supplier's sender address is added to your approved list.

Messages originating from unregistered or unapproved sender addresses will be rejected automatically.

5. Inspect the Attachment

Verify that the file is attached directly to the email, is not password-protected, and is not corrupted.

Confirm the file extension matches the expected configuration (e.g., .xlsx, .csv, .tsv, .txt).
Manually forward a copy of the email with the attachment to the feed address to test processing.

6. Confirm the Connection Method

Ensure the feed connection matches how your supplier delivers data:

Email with Attachment: Select when the file is attached directly to the message.
Email with URL: Select when the file must be downloaded from a link provided inside the email body.

If you change the connection method from Attachment to URL (or vice versa), previous emails will not reprocess; you must send a new email.

7. Check the Feed Schedule

Receiving an email does not always trigger an immediate sync run.

Review your scheduled execution times under Step 1: Source or on the Feed Detail page.
Feeds configured with scheduled runs will process the latest received email during their next scheduled run window unless manually triggered.

8. Validate File and Column Settings

Ensure your feed configuration aligns with the contents of the incoming file:

Confirm column header names in your mapping match the file headers exactly, as field names are case-sensitive.
Ensure delimiters and sheet names (for .xlsx files) match the format expected in Step 1.

9. Check Plan Variant and Product Limits

If an incoming file contains more products or variants than your subscription plan allows, the feed may fail to complete.

Use Store Product Filters or Incoming Feed Filters in Step 3 (such as Vendor or Category filters) to reduce processed row counts to remain within your plan quota.

10. Check Delivery and 550 Spam Errors

If your supplier receives a 550 spam-related bounce error, their mail server blocked or flagged the message before it arrived at Stock Sync.

The sender must contact their IT administrator or email provider to clear the spam classification and ensure outbound delivery to Stock Sync servers.

Key Rules & Technical Details

Case Sensitivity: Header mappings and subject keywords are strictly case-sensitive.
Attachment Storage: Stock Sync stores only the latest incoming email file per feed. Subsequent emails overwrite the pending file queue before the scheduled sync executes.

Troubleshooting Steps

Issue: Email sent, but feed log shows no incoming file received → Solution: Verify the recipient address character-for-character in Step 1 and check your forwarding rules or subject line filters.
Issue: Feed reports "No file found" for an Email with URL source → Solution: Confirm that the link inside the email body is a direct download URL that does not require login authentication.
Issue: Supplier receives a 550 error code when sending files → Solution: The sender's mail provider blocked the outgoing email. Have the supplier whitelist Stock Sync's domain with their mail host.
Issue: Email arrived, but products did not update immediately → Solution: Check your automated schedule settings; the feed will process the attachment on its next scheduled interval, or you can click Update to run it manually.

Good Articles to Continue

How to Get Gmail Auto-Forward Confirmation Code for Stock Sync → Step-by-step instructions to verify forwarding from a Google Workspace or Gmail account.
How to Set Up Email with Attachment Feed → Learn how to configure email source settings, delimiters, and file formats.
How to Set Up Store Product Filters → Filter specific catalog subsets to stay within your subscription's variant quotas.

Updated on: 28/10/2026

Was this article helpful?

Thank you!