WP-Force Images Download is the most complete, lightweight, and developer-friendly image download plugin for WordPress. Designed for photographers, wallpaper sites, digital asset stores, creative agencies, and content creators — it transforms any image into a secure, one-click force download with a
PricingFree downloadThe WordPress.org download is free. Pro versions, add-ons or external services may cost extra.
CompatibilityRequires WordPress 6.0 and PHP 7.4.
SourceWordPress plugins · Nov 4, 2026
01 / Source details
Aboutthistool.
WP-Force Images Download is the most complete, lightweight, and developer-friendly image download plugin for WordPress. Designed for photographers, wallpaper sites, digital asset stores, creative agencies, and content creators — it transforms any image into a secure, one-click force download with a pixel-perfect branded button.
Whether you need a simple [wpfid] shortcode or full programmatic control with PHP template tags, this plugin covers every use case with zero performance overhead.
🚀 Why WP-Force Images Download?
Most download plugins are bloated. This one is different:
Featherweight — Loads only one CSS file + one JS file on the frontend. No jQuery dependency for core functionality.
SaaS-grade Admin UI — Tabbed settings page with Live Button Preview so you see exactly what visitors will see before saving.
Future-proof — Uses wp_check_filetype() instead of hardcoded whitelists, so WebP, AVIF, HEIC and any new format WordPress adds is automatically supported.
Accessible — Buttons are semantic <button> elements with ARIA labels, full keyboard support, and WCAG 2.1 AA contrast compliance across all 4 styles.
Conflict-safe — All hooks, query args, nonce actions, and option keys use the wpfid_ namespace to eliminate conflicts with any other plugin.
✨ Core Features
🎨 4 Premium Button Styles Choose from four professionally engineered CSS button styles — all powered by CSS custom properties ( --wpfid-color , --wpfid-text ) for effortless theming:
Solid — Bold, filled CTA button with subtle elevation shadow.
Outline — Transparent background with a crisp colored border. Text color adapts on hover.
Soft / Ghost — Tinted semi-transparent background (powered by color-mix() ). Elegant and modern.
Text Only — Minimal styled link, zero background or borders. Perfect for inline usage.
🖼️ Universal Color System Set a global button color and text color once in the settings. Override them per-post using shortcode attributes. Supports HEX (#2271b1), RGB (rgb(255,0,0)), RGBA, and natural language color names (MidnightBlue, Tomato, DodgerBlue).
👁️ AJAX Live Preview The settings page features a real-time sticky preview widget powered by WordPress’s native wpColorPicker . Every change you make — style, color, icon, file size toggle — reflects instantly in the preview. No save → reload → check cycle.
⚡ AJAX Downloads (Zero Reload) When AJAX Downloads are enabled, visitors click the button and the file downloads immediately in-page using the Fetch API + Blob URL approach. No new tab opens. No page reloads. No redirect confusion.
📊 Download Stats Dashboard Every download is tracked using WordPress post meta. View a sortable, paginated analytics table from WPFID > Stats Dashboard in your admin. See which images are most popular, filter by date, and export data.
🤖 Auto-Attach Button Zero coding required. Enable Auto-Attach and the download button is automatically injected before or after post content on any public post type that has a featured image. Toggle per post type (Post, Page, custom CPTs).
🔐 Email Gate Require visitors to enter their email address before the download begins. The email is captured via AJAX (no page reload), securely saved to the database, and then the download starts automatically. Collected emails are viewable in the database or Stats page.
Note: The Email Gate uses a server-signed token cookie (HMAC via wp_hash() ) to verify submissions — not a plain cookie that could be forged.
🔒 Login Gate / Require Login Restrict downloads to logged-in users only. Unauthenticated visitors are redirected to the WordPress login page and returned to the download after successful authentication.
📐 Image Size Picker When enabled, a dropdown appears on the download button allowing visitors to choose between registered WordPress image sizes (Thumbnail, Medium, Large, Full, or any custom size registered by your theme).
🔢 Download Counter Optionally display the total download count directly below the button. Powered by post meta for instant reads and lightweight writes.
📁 Bulk Rename / Filename Templates Control exactly what filename visitors receive when they download, using a powerful variable templating system: %site_name%, %post_title% , %post_id% , %filename% , %timestamp% , %rand% , %md5%
🌐 Modern Format Support Powered by native wp_check_filetype() . The plugin automatically supports every image MIME type WordPress recognizes — including WebP, AVIF, HEIC, SVG, PNG, JPEG, GIF, BMP, ICO, and any future format added to WordPress Core. No configuration required.
🛡️ Enterprise-Grade Security – All form submissions verified with WordPress nonces (dual nonce on every download) – Email gate uses HMAC-signed cookies — immune to cookie-forgery attacks – Rate limiting: 30 requests per minute per IP prevents download abuse – Full input sanitization and output escaping on every field – PHP-level MIME type verification via finfo_open() on actual file contents – Session-aware download handler via admin-post.php + admin-ajax.php – defined('ABSPATH') || die() guard on every file
🖼️ Watermarking (Advanced) Automatically composite a watermark image onto downloaded photos. Supports PNG transparency. Preserves original image format (JPEG stays JPEG, PNG stays PNG).
🗜️ Gallery / ZIP Download Use the [wpfid_gallery ids="1,2,3"] shortcode to let visitors download multiple images as a single ZIP bundle.
🧩 Gutenberg Block A native block available in the WordPress block editor. Configure button title, color, custom link, size picker, and download count toggle — all from the Inspector sidebar.
🔌 Elementor Widget A dedicated Elementor widget lets Elementor users insert download buttons with full control from the Elementor panel — no shortcode knowledge required.
🛠️ Usage
Basic Shortcode Place in any Post, Page, or Widget: [wpfid]
With Custom Label [wpfid title=”Download HD Wallpaper”]
With Specific Image URL [wpfid link=”https://example.com/my-image.jpg”]
With Color Overrides [wpfid color=”#e83e8c” textcolor=”#ffffff”]
Combined Example [wpfid title=”Get the Image” color=”MidnightBlue” textcolor=”white” new_name=”%post_title%”]
Gallery / ZIP Download [wpfid_gallery ids=”10,20,30″ title=”Download All Images (ZIP)”]
PHP Template Tag (for theme developers)
Or use the direct function call:
📋 Shortcode Attributes Reference
Attribute Default Description
title Download Button label text
link (featured image) Direct URL to the image to download
color Settings value Button background color (HEX, RGB, or color name)
textcolor Settings value Button text/icon color
new_name Settings value Filename template for the downloaded file
class (empty) Additional CSS class(es) on the button wrapper
size_picker Settings value "true" / "false" — show image size dropdown
show_count Settings value "true" / "false" — show download count below button
📈 SEO, GEO & AI Optimization
Semantic HTML5 Output Every download button is a native <button> or <a> element with descriptive title attributes and aria-label support. No div-soup, no generic onClick handlers — pure semantic markup that search engine crawlers and AI language models can interpret correctly.
Schema & Structured Data Ready The plugin output is compatible with DigitalDocument and ImageObject schema markup. You can wrap the shortcode output in your own schema markup to signal to Google that this is a downloadable asset.
Core Web Vitals Safe – CSS is loaded with wp_enqueue_style() with versioned cache-busting – JavaScript is deferred (loaded in footer) and only runs on pages with the shortcode – Zero render-blocking resources introduced – No external font or icon CDN calls — uses WordPress Dashicons (already loaded) – File-size display is transient-cached (6 hours) — no live HTTP request on every page view
Translation Ready (GEO / i18n) Every user-facing string is wrapped in __() , esc_html__() , or esc_html_e() translation functions with the wp-force-images-download text domain. Compatible with WPML, Polylang, Loco Translate, and TranslatePress for multilingual and geographic market targeting.
AI / LLM Crawler Compatibility The plugin generates standard HTML anchor elements with meaningful title and download attributes, making button intent clear to AI-powered crawlers (GPTBot, Google Bard, Applebot) without requiring additional structured data.
See it in action
A closer look.
Live Button Preview — Real-time sticky preview widget that updates as you change colors and styles.
02 / Source details
Gettingstarted.
Method 1: WordPress Plugin Repository (Recommended) 1. Go to Plugins > Add New in your WordPress Dashboard. 2. Search for WP Force Images Download . 3. Click Install Now , then Activate .
Method 2: Manual Upload 1. Download the plugin .zip file. 2. Go to Plugins > Add New > Upload Plugin . 3. Choose the zip file and click Install Now . 4. Click Activate Plugin .
Method 3: FTP/SFTP 1. Unzip and upload the wp-force-images-download folder to /wp-content/plugins/ . 2. Activate via Plugins in WordPress admin.
After Activation – A branded notification banner appears welcoming you to v2.6. – Navigate to WPFID > Settings in your admin sidebar. – Use the 🎨 Button Design tab to style your button with the Live Preview. – Use the ⚙️ Behaviour & Features tab to enable Email Gate, Login Gate, Auto-Attach, etc. – Deploy [wpfid] anywhere in your content.
03 / Source details
Frequently asked questions.
How do I add a download button to a post?
Simply add the shortcode [wpfid] to any post or page. The plugin will automatically detect the post’s featured image and force-download it. If you want a specific image, use [wpfid link="https://your-image-url.com/image.jpg"] .
Where do I find the settings?
Navigate to WPFID > Settings in your WordPress admin sidebar. The settings page has three tabs: Button Design, Behaviour & Features, and Shortcode Help.
How do I track downloads?
Go to WPFID > Stats Dashboard . Every download is tracked automatically. You’ll see a table with post titles, download counts, last downloaded time, and direct links.
How does the Email Gate work?
When “Require Email” is enabled, visitors see an email input field next to the download button. After entering a valid email and clicking the button, the email is saved to the database and the download starts automatically — all without any page reload. Collected emails are stored in wp_options under wpfid_collected_emails . The gate uses a cryptographically signed cookie token so it cannot be bypassed by simply setting a cookie manually.
How does the Login Gate work?
When “Require Login” is enabled, clicking the download button redirects unauthenticated users to the WordPress login page. After a successful login, they are returned to the original page.
Does this plugin support WebP, AVIF, HEIC images?
Yes. The plugin uses WordPress’s native wp_check_filetype() function instead of a hardcoded whitelist. This means it automatically supports every image format WordPress recognizes — including WebP, AVIF, HEIC, PNG, JPEG, GIF, SVG, BMP, ICO, and any format added in future WordPress updates.
Can I customize the button colors?
Yes, in two ways: (1) Set universal colors in WPFID > Settings > Button Design — this applies to all buttons site-wide. (2) Override per-post using shortcode attributes: [wpfid color="#ff0000" textcolor="#ffffff"] . Color values can be HEX, RGB, RGBA, or English color names like Tomato , MidnightBlue , DodgerBlue .
Can I rename the downloaded file?
Yes. Use the new_name attribute in the shortcode: [wpfid new_name="%post_title%_%rand%"] . Or set a global rename pattern in WPFID > Settings > Behaviour & Features > Rename Pattern . Available variables: %site_name% , %post_title% , %post_id% , %filename% , %timestamp% , %rand% , %md5% .
Does AJAX download mode work for all file types?
Yes. AJAX download mode uses the Fetch API to retrieve the file as a binary blob and triggers the download via a programmatic anchor click. It works for all image formats and falls back gracefully to a normal form POST in older browsers.
Will the plugin slow down my site or hurt SEO?
No. The plugin is carefully optimized: CSS and JS only load on pages where the shortcode is used, all assets are versioned for cache efficiency, no render-blocking scripts, no external CDN calls, and the button output is pure semantic HTML5. File-size display results are cached in transients for 6 hours.
Is the plugin compatible with Gutenberg?
Yes. A native Gutenberg block (WPFID Download Button) is available directly in the block inserter under the Widgets category. Configure all button settings directly in the Inspector sidebar. You can also use the Shortcode block with [wpfid] .
Does it work with WooCommerce or custom post types?
Yes. The shortcode works in any content area. Auto-Attach can be enabled for any registered public post type, including WooCommerce products. WooCommerce purchase gating is also available via the product_id parameter.
How do I display the button in my theme’s PHP files?
Use <?php echo do_shortcode('[wpfid]'); ?> anywhere in your template files. Or use the direct template tag: <?php wp_fid( 'Download', '#2271b1' ); ?> .
Is the plugin GDPR compliant regarding email collection?
The Require Email feature collects email addresses entered voluntarily by users. You are responsible for disclosing this in your privacy policy. The emails are stored in your own WordPress database (never sent to a third party). We recommend adding a consent checkbox or linking to your privacy policy near the email field using Custom CSS or hooks.
Is there a REST API?
Yes. The endpoint GET /wp-json/wpfid/v1/download/{attachment_id} returns a signed download URL for headless or external clients. If “Require Login” is enabled in settings, the endpoint automatically requires authentication. The returned URL includes valid nonces for 24 hours.
Website LLMs.txt and LLMs-Full.txt Generator is an LLMs.txt generator and llms-full.txt generator for WordPress. It helps site owners generate, manage, preview, validate, and serve AI discovery files from published public content. Use it to create structured /llms.txt and optional /llms-full.txt end
EngageDock AI is a customizable floating contact widget for WordPress websites that want more leads and faster visitor communication. It helps small businesses turn website traffic into calls, texts, emails, and callback requests from one clean contact panel. Key Features: Click-to-Call – One tap ca
Altify AI is an auto ALT text and AI ALT text plugin for WordPress images. It helps generate descriptive image ALT text for accessibility and image SEO. Use bulk image ALT text tools for your Media Library, generate featured image ALT text automatically, and scale WooCommerce image ALT updates with
The Accepted Payment Methods plugin is a straightforward, lightweight solution that enhances your website by displaying visually appealing icons of the payment methods you accept. This plugin is ideal for a variety of websites, including e-commerce platforms, service-oriented websites, and informati
