Troubleshooting

Attachments Are Not Being Sent

File Does Not Exist

Check that the file exists in the media library:

1. Go to Media
2. Find the attachment
3. Verify that the file is available

Wrong Email

Verify that you have selected the correct email:

1. In the attachment settings, check the Attach to emails field
2. Make sure the email that is being sent is selected

Country Restriction

If you have Enabled countries set:

1. Check if the order country matches the list
2. Leave the field empty for all countries

Email Is Blocked

Attachments Too Large

Some email providers block emails with large attachments:

• Gmail: max 25 MB
• Outlook: max 20 MB
• Most hosting providers: max 10-25 MB

Solution:

• Reduce file sizes
• Use a download link instead of an attachment

Blocked File Types

Some file types are blocked:

• .exe, .bat, .cmd
• Password-protected archives

Recommended formats:

• PDF documents
• Images (JPG, PNG)

Product Attachment Is Not Attached

Attachment Is Not Set for the Product

1. Open the product detail
2. Select the Attachments tab
3. Set up the attachments
4. Save the product

Email Is Not Selected

In the product attachment settings, check the Attach to emails field.

Custom Fields Are Not Working

Path Does Not Exist

The module checks for file existence:

if ( file_exists( $field['custom_field'] ) ) {
    $attachments[] = $field['custom_field'];
}

Check:

1. That the order meta contains the correct path
2. That the file exists at the path
3. That the path is absolute

Meta Key Is Wrong

Make sure you are entering the correct meta key (including the underscore at the beginning, if used).

Diagnostics

Checking Attachments in Email

add_filter( 'woocommerce_email_attachments', function( $attachments, $email_id, $order ) {
    error_log( sprintf(
        'Email: %s, Attachments: %s',
        $email_id,
        print_r( $attachments, true )
    ) );

    return $attachments;
}, 999, 3 );

Checking Module Settings

$module = wpify_woo_container()->get(
    \WpifyWoo\Modules\EmailAttachments\EmailAttachmentsModule::class
);

$settings = $module->get_setting( 'email_attachments' );
print_r( $settings );

Checking Product Attachments

$attachments = get_post_meta( $product_id, 'email_attachments', true );
print_r( $attachments );

Performance

Too Many Attachments

Each attachment increases email size and sending time:

• Limit the number of attachments per email
• Consider using links instead of attachments
• Use the Asynchronous Emails module to improve performance

Large Files

For large files:

1. Compress PDF documents
2. Optimize images
3. Consider splitting into multiple emails

Emails Are Not Being Delivered

Check Spam Folder

Emails with attachments have a higher probability of being marked as spam:

1. Check the spam folder
2. Use an SMTP plugin for better deliverability
3. Set up SPF and DKIM records