> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shiipp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Not Receiving Emails

> Troubleshooting guide for when customers are not receiving emails from the system.

# Troubleshooting Email Delivery

<Info>
  If customers or staff report that they are not receiving emails (such as pre-alerts, invoices, or marketing broadcasts) from the system, follow this guide to identify and resolve the issue quickly.
</Info>

<Steps>
  <Step title="Check the Email Logs">
    The first step is always to check the system's **Email Logs** to see if the email was generated and sent by the platform. You can check these logs in two places:

    <Tabs>
      <Tab title="Customer Profile">
        Go to **Operations > Customers**, search for the user, open their profile, and click on the **Emails** tab. This will show a history of emails sent specifically to this customer.

        <Frame>
          <img src="https://mintcdn.com/shiipp-courier/JLEXS2FMNTXnaaUM/images/image-2.png?fit=max&auto=format&n=JLEXS2FMNTXnaaUM&q=85&s=70ce2afe4482ecf9d7acad43a7a24988" alt="Image" width="2468" height="1764" data-path="images/image-2.png" />
        </Frame>
      </Tab>

      <Tab title="Global Email Logs">
        Navigate to **Administration > Email Logs**. Here you can search for the recipient's email address or filter by date.

        <Frame>
          <img src="https://mintcdn.com/shiipp-courier/JLEXS2FMNTXnaaUM/images/image-3.png?fit=max&auto=format&n=JLEXS2FMNTXnaaUM&q=85&s=f04f8e5db7fb7bb96dcf2083c74b0f19" alt="Image" width="3104" height="1964" data-path="images/image-3.png" />
        </Frame>
      </Tab>
    </Tabs>

    When reviewing the logs, check the **Delivery Status** and the **Error Message**. The system receives data directly from the email server providing specific reasons if an email fails.

    <Frame>
      <img src="https://mintcdn.com/shiipp-courier/JLEXS2FMNTXnaaUM/images/image-4.png?fit=max&auto=format&n=JLEXS2FMNTXnaaUM&q=85&s=a12018c4541022912376f0fee4a3cada" alt="Email log details with delivery error" width="3080" height="1964" data-path="images/image-4.png" />
    </Frame>

    ### Common Statuses and Errors:

    <AccordionGroup>
      <Accordion title="Delivered / Opened" icon="check">
        The email was successfully delivered to the recipient's email provider. If they still can't see it, it is likely in their **Spam** or **Junk** folder.
      </Accordion>

      <Accordion title="Failed - Invalid Address" icon="triangle-exclamation">
        The log might show an error like `Invalid address: (to): name@gmail` or `user@2345`. This means the email address is malformed (e.g., missing `.com`).
      </Accordion>

      <Accordion title="Failed - Authentication / Connection" icon="server">
        Errors such as `SMTP Error: Could not authenticate` or `SMTP Error: Could not connect to SMTP host` indicate an issue with your system's SMTP or email provider configuration.
      </Accordion>

      <Accordion title="Bounced" icon="rotate-left">
        The email was rejected by the recipient's server. This often happens if the email address doesn't exist or their inbox is full. Example error: `Permanent SMTP delivery error`.
      </Accordion>

      <Accordion title="Held / Suppression List" icon="shield-halved">
        If an email bounces multiple times, the provider may place it on a suppression list to protect your sender reputation. Example error: `Recipient is on the suppression list (reason: too many hard fails)`.
      </Accordion>

      <Accordion title="Check for existence" icon="magnifying-glass">
        If there is no log entry at all, the system never triggered the email. Check if the action that triggers the email (e.g., package status change) actually occurred.
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="Verify the Customer's Email Address">
    As seen from the "Invalid Address" errors above, emails are frequently not received simply because of a typo in the customer's profile.

    1. Go to **Operations > Customers** and search for the user.
    2. Click on their name to open the **Customer Profile**.
    3. Verify that the email address on file is exactly correct (checking for missing `.com`, misspelled domains, etc.).

    <Note>
      If there's a typo, update their profile immediately to ensure future communications are delivered.
    </Note>
  </Step>

  <Step title="Ask the Recipient to Check Spam/Junk Folders">
    If the Email Logs show the message as sent but the customer hasn't seen it, their email provider (e.g., Gmail, Outlook, Yahoo) might have filtered it.

    * Ask the customer to check their **Spam**, **Junk**, or **Promotions** folder.
    * Advise them to add your sending email address to their contacts or **"Safe Senders"** list to ensure future emails go straight to their inbox.
  </Step>

  <Step title="Check System Email Configuration">
    If *no one* is receiving emails and the logs show consistent failures (or if no logs are being generated for system-wide actions), there may be an issue with the underlying email configuration.

    * Verify that your SMTP settings or Email Provider integration is correctly set up.
    * Check if your email provider account is in good standing (e.g., not suspended, no billing issues).

    <Warning>
      Ensure your domain's DNS records (SPF, DKIM, DMARC) are properly configured. Poor DNS configuration can cause major email providers to silently drop your emails.
    </Warning>
  </Step>
</Steps>

***

## Still Need Help?

<CardGroup cols={2}>
  <Card title="Contact Support" icon="headset" href="#">
    If you have gone through these steps and emails are still not being delivered, please contact support and provide details from the Email Logs.
  </Card>
</CardGroup>
