Amazon S3 for WooCommerce – Complete Documentation

Amazon S3 for WooCommerce lets you securely and reliably deliver digital products—such as downloads, music, PDF resources, design files, or software—directly from your Amazon S3 bucket through your WooCommerce store. The plugin uses presigned URLs for time-limited, piracy-resistant file access, supporting large files and high-traffic stores while eliminating the bandwidth limitations of your web host.

Table of Contents

1. Overview & Key Features

S3 Delivery WooCommerce Pro is the most secure, easiest way to deliver digital products from Amazon S3 via WooCommerce. Your customers get beautiful, expiring download links and you get total control—no public S3 URLs, no confusion, no headaches. Designed for non-coders and developers alike.

Core Features

  • Secure, expiring Amazon S3 download links for every WooCommerce order
  • Prominent, styled “Download” button for customers (no CSS or theme edits required)
  • 30-second customer support workflow – generate fresh download links instantly
  • Admin testing without incognito mode – test links with one click
  • Works with all digital file types (PDF, ZIP, video, images, audio, and more)
  • Instant test & debug tools built in
  • Auto-injected CSS: looks great on any theme
  • Admin-only logs and troubleshooting
  • Easy setup in minutes

Perfect For

  • Selling WordPress plugins, themes, or digital products
  • Delivering large files without hosting bandwidth limits
  • Professional customer support for lost or expired download links
  • Churches, ministries, and non-profits delivering digital resources
  • Anyone who needs secure, reliable file delivery through WooCommerce

Back to Top

2. Installation & First Steps

Install the Plugin

  1. Upload the plugin: Upload s3-delivery-woocommerce-pro.zip to /wp-content/plugins/ or install via the WordPress admin panel
  2. Activate the plugin: Go to Plugins → Installed Plugins → Activate S3 Delivery WooCommerce Pro
  3. Locate the menu: Find the new “S3 Delivery Pro” menu item in your WordPress admin sidebar

Configure AWS Credentials

  1. Navigate to: S3 Delivery Pro → S3 Delivery Pro (first submenu item)
  2. Enter AWS Details:
    • AWS Access Key ID
    • AWS Secret Access Key
    • S3 Region (must match your bucket)
    • S3 Bucket Name (case-sensitive)
    • Link Expiry Time (default: 60 minutes)
  3. Save Changes

That’s it—you’re ready to connect your products!

Understanding the Menu Structure

After installation, you’ll see these pages under “S3 Delivery Pro”:

Menu ItemPurposeWhen to Use
S3 Delivery ProConfigure AWS credentials and settingsInitial setup, changing S3 bucket
Download LinksGenerate download links by order IDDaily customer support
Test DownloadsTest files by product IDVerify S3 files are attached correctly
Debug ToolsView logs and troubleshoot issuesWhen something isn’t working

Back to Top

3. Plugin Settings

Navigate to S3 Delivery Pro → S3 Delivery Pro to access all configuration options.

AWS Configuration

AWS Access Key ID
Your AWS access key with S3 s3:GetObject permission. Create this in AWS IAM.

AWS Secret Access Key
Your AWS secret key (kept secure and never displayed after saving).

S3 Region
Must match your S3 bucket’s region. Common options:

  • us-east-1 (US East – N. Virginia)
  • us-west-2 (US West – Oregon)
  • eu-west-1 (Europe – Ireland)

S3 Bucket Name
The exact name of your Amazon S3 bucket. Case-sensitive, no trailing slashes.

Download Link Settings

Link Expiry (minutes)
How long download links remain active. Default: 60 minutes.

  • Shorter time = More secure
  • Longer time = More customer convenience
  • Recommended: 60-120 minutes

Debug Options

Enable Debug Logging
Check this to log all download attempts and plugin actions. Logs are admin-only and help troubleshoot issues.

Note: Debug logs can be viewed and downloaded from the Debug Tools page.

Back to Top

4. Attaching S3 Files to Products

You can attach one or more Amazon S3 files to any WooCommerce product. Each file can have a user-friendly label (Display Name) and the S3 Object Key (the path in your bucket).

Step-by-Step

  1. Edit a product in WooCommerce (Products → All Products → Edit)
  2. Scroll to Product Data panel
  3. Click the “Amazon S3 Files” tab

 

  1. Add file details:
    • Display Name: What customers see (e.g., “WordPress Plugin v2.0”)
    • S3 Object Key: Full path in S3 bucket (e.g., 2026/my-plugin.zip)
  2. Click “Add File” to add more files to the same product
  3. Save the product

 

S3 Object Key Format

The S3 Object Key must match exactly what’s in your S3 bucket:

✅ Correct Examples:

  • 2026/wordpress-plugin.zip
  • plugins/my-product-v1.0.zip
  • downloads/ebook.pdf

❌ Incorrect Examples:

  • /2026/file.zip (don’t include leading slash)
  • file.zip (include folder if file is in one)
  • 2026\file.zip (use forward slashes, not backslashes)

Multiple Files Per Product

You can attach multiple files to one product:

  • Main plugin file
  • Documentation PDF
  • Video tutorial
  • Bonus materials

Each file gets its own download button with its Display Name.

Back to Top

5. Customer Support Workflow

The 30-Second Support Process

When a customer emails “I lost my download link,” here’s your workflow:

Step 1: Open Download Links
Navigate to S3 Delivery Pro → Download Links

Step 2: Enter Order ID
Type or paste the order number (find it in WooCommerce → Orders)

Step 3: Generate Links
Click the blue “Generate Download Links” button

Step 4: Test the Link
Click the “Test” button next to the generated link

  • As an admin, you can test directly (no incognito mode needed!)
  • File downloads successfully? You’re good to go ✅

Step 5: Email to Customer

  • Enter customer’s email address
  • Click “Send via Email”
  • Or copy the link and paste into your own email

Total Time: 30 seconds ⚡

Testing Tip

💡 To test links before sending to customers, simply click the “Test” button. As a logged-in administrator, the ownership check is automatically bypassed so you can verify downloads work correctly. No incognito mode or private browsing required!

Email Template

Hi [Customer Name],

Here's your download link for order #[ORDER_ID]:

[DOWNLOAD LINK]

This link expires in 60 minutes for security, so please download soon.

If you have any issues downloading, just reply to this email and I'll help you out.

Thanks for your purchase!

[Your Name]

Common Support Scenarios

“I accidentally deleted the download email”
→ Generate fresh link, takes 30 seconds

“The download link expired”
→ Generate fresh link with new 60-minute window

“I need to download on a different device”
→ Generate fresh link, customer can use on any device

“The file won’t download”
→ Use Test Downloads page to verify S3 file exists and is configured correctly

Back to Top

6. Testing & Debugging

Test Downloads Page

Use this page to verify S3 files are attached correctly to products.

Navigate to: S3 Delivery Pro → Test Downloads

Process:

  1. Enter a Product ID (find in Products → All Products)
  2. Click “Generate Test Links”
  3. Review the S3 files attached to that product
  4. Click “Test Download” to verify the file downloads correctly

When to use:

  • After attaching S3 files to a new product
  • Troubleshooting customer download issues
  • Verifying S3 bucket configuration

Debug Tools

Enable detailed logging to troubleshoot issues.

Navigate to: S3 Delivery Pro → Debug Tools

Features:

  • Enable Debug Logging: Track all download attempts and plugin actions
  • View Logs: See recent activity and error messages
  • Download Logs: Save logs for support tickets
  • Clear Logs: Remove old log entries

When to enable:

  • Setting up the plugin for the first time
  • Customer reports download issues
  • Testing new S3 bucket or AWS credentials
  • Submitting support requests

Built-in Connection Test

The settings page includes a connection test feature:

  1. Go to S3 Delivery Pro → S3 Delivery Pro
  2. Scroll to the bottom
  3. Click “Test AWS Connection”
  4. Verify your credentials and bucket access are working

Back to Top

7. Customer Download Experience

After purchase, your customers see a large, blue “Download” button in their order details page—styled for maximum clarity and conversion.

What Customers See

Order Confirmation Email:

  • Standard WooCommerce order details
  • Clear “Download” button or link
  • Works with every email client

My Account → Orders:

  • Order history with download buttons
  • Each file listed with its Display Name
  • Professional, easy-to-find download access

Order Details Page:

  • Prominent blue “Download” button
  • Multiple files shown separately
  • Clear expiration information (if applicable)

Customer Experience Benefits

✅ Works with every WooCommerce theme – no custom CSS required
✅ No more missed links or support tickets about “where’s my download”
✅ Professional appearance – builds trust and credibility
✅ Mobile-friendly – downloads work on any device
✅ Secure – each link is unique to the customer and order

Visual Comparison

Before S3 Delivery Pro:
Plain text download link (easily missed, unprofessional)

After S3 Delivery Pro:
Large blue download button (impossible to miss, professional appearance)

Back to Top

8. FAQ & Troubleshooting

General Questions

Q: Why do files sometimes open in the browser instead of downloading?

Browsers may auto-display certain file types (like PDFs or images). The plugin sets Content-Disposition: attachment, but browser settings can override this. Tell customers to right-click and select “Save Link As” to force download.

Q: What file types are supported?

Any file type that can be stored in Amazon S3—PDF, ZIP, MP4, MP3, JPG, PNG, DOCX, etc. No limits on file types.

Q: How large can files be?

Amazon S3 supports files up to 5TB. Your only limit is S3 storage space.

Q: Can customers share their download links?

No. Each link is order-specific, user-specific, and expires after your configured time window (default 60 minutes). Links cannot be shared or reused.

Q: Is custom CSS or theme editing required?

No. All styling is automatically applied by the plugin. Works with any WordPress theme out of the box.

Troubleshooting

Issue: “Invalid or expired download link” error

Solutions:

  1. Generate a fresh link (Download Links page)
  2. Verify S3 Object Key exactly matches AWS console
  3. Check AWS credentials in plugin settings
  4. Test AWS connection from settings page

Issue: Download links not appearing for customers

Solutions:

  1. Edit product → Amazon S3 Files tab → verify files are attached
  2. Check order status is “Completed” or “Processing”
  3. Manually generate link via Download Links page

Issue: Testing doesn’t work (admin ownership error)

This was fixed in v2.0.8.

Solution:

  1. Update to v2.0.8 or later
  2. Logged-in admins can now test links directly
  3. No incognito mode required for admin testing

Back to Top

9. Support & Resources

Getting Support

Email Support: [email protected]

When contacting support, please include:

  • Your order number
  • WordPress version
  • WooCommerce version
  • Plugin version
  • Description of the issue
  • Debug logs (if available)
  • Screenshots

Response time: Within 24-48 hours on business days

Quick Reference

Daily Customer Support:
S3 Delivery Pro → Download Links → Enter Order ID → Generate → Test → Email

Testing Product Downloads:
S3 Delivery Pro → Test Downloads → Enter Product ID → Generate Test Links → Test

Troubleshooting Issues:
S3 Delivery Pro → Debug Tools → Enable Logging → View Logs

Configuration:
S3 Delivery Pro → S3 Delivery Pro → Enter AWS credentials → Save

Back to Top

Version Information

Current Version: 2.0.8
Last Updated: January 2026
Compatibility: WordPress 5.8+, WooCommerce 5.0+, PHP 7.4+

Recent Updates (v2.0.8)

  • ✅ Fixed double URL-encoding issue with S3 keys
  • ✅ Added admin override for ownership check (test without incognito)
  • ✅ Improved backward compatibility with older links
  • ✅ Enhanced Download Links generator interface

Questions? Email [email protected] for support.

Back to Top