Requirements & Compatibility

Updated Jan 26, 2026 Getting Started

Overview

WordPress Download Manager is designed to work with most WordPress hosting environments. This guide outlines the minimum and recommended requirements for optimal performance.

Prerequisites

Active WordPress installation
FTP/SFTP access or WordPress admin file upload capability
Basic understanding of WordPress plugin installation

Quick Start

Most modern WordPress hosts meet all requirements. If you can run WordPress 5.0+, you can run WPDM.

Server Requirements

Minimum Requirements

Component	Minimum	Notes
WordPress	5.0	Core functionality requires 5.0+
PHP	7.4	Security support ended Dec 2022
MySQL	5.6	Or MariaDB 10.0+
Memory	128MB	PHP memory_limit

Recommended Requirements

Component	Recommended	Notes
WordPress	6.4+	Latest features and security
PHP	8.1+	Best performance and security
MySQL	8.0	Or MariaDB 10.6+
Memory	256MB+	Required for large file handling

PHP Extensions

These PHP extensions are required or recommended:

Extension	Required	Purpose
`curl`	Yes	Remote file operations, API calls
`zip`	Yes	Creating ZIP archives for multi-file packages
`mbstring`	Yes	Multibyte string handling
`json`	Yes	JSON encoding/decoding
`gd` or `imagick`	Recommended	Image processing for thumbnails
`openssl`	Recommended	Secure connections, encryption
`fileinfo`	Recommended	MIME type detection

PHP Configuration

Adjust these settings in php.ini or via .htaccess for optimal performance:

; Memory and execution
memory_limit = 256M
max_execution_time = 300

; File uploads
upload_max_filesize = 256M
post_max_size = 256M
max_file_uploads = 20

; Session handling
session.gc_maxlifetime = 3600

Setting via .htaccess (Apache)

php_value memory_limit 256M
php_value upload_max_filesize 256M
php_value post_max_size 256M
php_value max_execution_time 300

Setting via wp-config.php

define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');

WordPress Compatibility

Core WordPress

WPDM Version	WordPress Compatibility
6.x	WordPress 5.0 – 6.4
7.x	WordPress 5.6 – 6.5+

Multisite Support

WordPress Download Manager fully supports WordPress Multisite:

Network-wide activation
Per-site configuration
Shared file storage options
Network admin controls

Block Editor (Gutenberg)

Full Gutenberg compatibility with dedicated blocks:

WPDM Package block
WPDM Packages list block
WPDM Categories block
WPDM Search block

Classic Editor is also fully supported.

Theme Compatibility

WPDM works with any properly-coded WordPress theme. Tested with:

Twenty Twenty-Four (and all default themes)
Astra
GeneratePress
Flavor starter theme
Flavor starter theme flavor developer
Flavor starter theme flavor developer flavor
Flavor starter theme flavor developer flavor developer

Theme Requirements

Your theme should:

Include wp_head() in header
Include wp_footer() before
Support the_content filter
Not override WordPress query handling

Custom Post Type Archives

If your theme supports custom post type archives, WPDM integrates automatically. Otherwise, use shortcodes or the Archive Page add-on.

Plugin Compatibility

Fully Compatible

Plugin	Notes
Yoast SEO	Full meta, sitemap, breadcrumb support
Rank Math	SEO integration
WooCommerce	Can coexist; use Premium Packages for WPDM e-commerce
WPML	Multilingual package support
Polylang	Multilingual support
Wordfence	Security scanning compatible
WP Super Cache	Caching compatible
W3 Total Cache	Caching compatible
Elementor	Widget add-on available
WPBakery	Shortcode support

Known Conflicts

Plugin	Issue	Solution
Download Monitor	Shortcode conflicts	Use one or the other
Some security plugins	May block download URLs	Whitelist WPDM paths
Aggressive caching	May cache download pages	Exclude `/download/` URLs

Caching Plugin Configuration

For caching plugins, exclude these URLs:

/download/*
/?wpdmdl=*
/checkout/*
/cart/*

Browser Compatibility

Desktop Browsers

Browser	Minimum Version
Chrome	90+
Firefox	88+
Safari	14+
Edge	90+

Mobile Browsers

Browser	Support
Chrome Mobile	Full support
Safari iOS	Full support
Firefox Mobile	Full support
Samsung Internet	Full support

JavaScript Requirements

WPDM requires JavaScript enabled for:

Download button interactions
Lock form submissions
Admin panel functionality
AJAX-based features

Hosting Recommendations

Shared Hosting

Works on most shared hosts. Ensure:

PHP 7.4+ available
Sufficient disk space for files
No aggressive resource limits

VPS/Dedicated

Recommended for high-traffic sites or large file libraries.

Managed WordPress Hosting

Tested and compatible with:

WP Engine
Kinsta
Flywheel
SiteGround
Flavor starter theme flavor developer flavor developer flavor
Flavor starter theme flavor developer flavor developer flavor developer

Cloud Hosting

For large file storage, consider cloud integrations:

Amazon S3 (via add-on)
Google Cloud Storage (via Google Drive add-on)
DigitalOcean Spaces (S3-compatible)

File System Requirements

Directory Permissions

Directory	Permission	Purpose
`/wp-content/uploads/`	755	WordPress uploads
`/wp-content/uploads/download-manager-files/`	755	WPDM file storage
`/wp-content/uploads/wpdm-cache/`	755	Temporary files

Disk Space

Plan disk space based on your needs:

Usage	Recommended Space
Small site (<100 files)	5GB
Medium site (100-1000 files)	50GB
Large site (1000+ files)	200GB+

Consider cloud storage add-ons for unlimited scaling.

SSL/HTTPS

Recommendation

HTTPS is strongly recommended for:

Secure file downloads
Payment processing (required for Premium Packages)
User data protection
SEO benefits

Configuration

Ensure WordPress URLs use HTTPS:

// wp-config.php
define('FORCE_SSL_ADMIN', true);

Database Requirements

Table Prefix

WPDM uses the ahm_ prefix for custom tables:

wp_ahm_download_stats
wp_ahm_emails
wp_ahm_sessions
(and others)

Database Size

Estimated database growth:

Downloads/Month	Approx. DB Growth
1,000	~5MB/month
10,000	~50MB/month
100,000	~500MB/month

Consider periodic cleanup for high-volume sites.

Checking Your Environment

Health Check Plugin

Install the Site Health plugin (built into WordPress 5.2+):

Go to Tools > Site Health
Review PHP version, extensions, and limits
Address any critical issues

WPDM System Status

After installation:

Go to Downloads > Settings > System Info
Review detected configuration
Note any warnings

Troubleshooting Compatibility

PHP Version Issues

Symptom: White screen or fatal errors on activation

Solution: Upgrade PHP via hosting control panel or contact host

Memory Limit Issues

Symptom: “Allowed memory size exhausted” errors

Solution: Increase memory_limit in php.ini or wp-config.php

Upload Size Issues

Symptom: Large files fail to upload

Solution: Increase upload_max_filesize and post_max_size

Permission Issues

Symptom: Files don’t save or download

Solution: Set correct directory permissions (755) and file permissions (644)