Frequently Asked Questions

What file formats are supported?

The module supports all formats of files that can be uploaded to the WordPress media library:

• PDF documents
• Images (JPG, PNG, GIF)
• Documents (DOC, DOCX, XLS, XLSX)
• Archives (ZIP)

However, some email providers may block certain file types (especially executable files).

How do I add an attachment only for a specific country?

In the attachment settings:

1. Find the Enabled countries field
2. Select the countries for which you want to add the attachment
3. Leave empty for all countries

The module checks the shipping country (or billing country if shipping is not set).

Can I add multiple files to one email?

Yes, in the Attachments field you can select multiple files from the media library.

You can also create multiple rules for the same email with different conditions.

How do I add an attachment to a specific product?

1. Open the product detail in the administration
2. In the Product data section, select the Attachments tab
3. Set up attachments the same way as global ones
4. Save the product

Attachments will only be added to orders containing this product.

What are "Custom fields"?

Custom fields allow you to dynamically load file paths from order meta data.

Example usage:

1. An invoicing plugin saves the path to a PDF invoice in _invoice_pdf_path
2. In the attachment settings, enter the meta key _invoice_pdf_path
3. The module automatically attaches the invoice to the email

What is the maximum attachment size?

It depends on your hosting and email provider:

• Hosting: usually 25-50 MB per email
• Gmail: max 25 MB
• Outlook: max 20 MB

For large files, we recommend using a download link instead of an attachment.

Why was the attachment not sent?

Possible causes:

1. File does not exist - check the media library
2. Wrong email - verify the email selection in settings
3. Country restriction - check the enabled countries settings
4. Email blocked - attachment too large or spam filter

Can I add an attachment to a welcome email?

The module is primarily designed for order emails. Emails such as:

• Account registration
• Password reset
• Welcome email

are not supported because they do not pass through the woocommerce_email_attachments filter.

How do I automatically attach an invoice to an email?

It depends on your invoicing plugin:

1. Plugin saves path to order meta:

   • Use “Custom fields” and enter the meta key

2. Plugin has its own integration:

   • Most invoicing plugins have their own settings for attachments

3. Custom code:

   add_filter( 'woocommerce_email_attachments', function( $attachments, $email_id, $order ) {
       $invoice = get_post_meta( $order->get_id(), '_invoice_path', true );
       if ( $invoice ) {
           $attachments[] = $invoice;
       }
       return $attachments;
   }, 10, 3 );

Do attachments slow down order processing?

Yes, large attachments can slow down the order process. We recommend:

1. Activating the Asynchronous Emails module
2. Optimizing file sizes
3. Limiting the number of attachments