Title: WP Attachments
Author: Marco Milesi
Published: <strong>January 7, 2012</strong>
Last modified: March 14, 2026

---

Search plugins

![](https://ps.w.org/wp-attachments/assets/banner-772x250.png?rev=3308377)

![](https://ps.w.org/wp-attachments/assets/icon-256x256.png?rev=2617427)

# WP Attachments

 By [Marco Milesi](https://profiles.wordpress.org/milmor/)

[Download](https://downloads.wordpress.org/plugin/wp-attachments.5.3.4.zip)

 * [Details](https://wordpress.org/plugins/wp-attachments/#description)
 * [Reviews](https://wordpress.org/plugins/wp-attachments/#reviews)
 *  [Installation](https://wordpress.org/plugins/wp-attachments/#installation)
 * [Development](https://wordpress.org/plugins/wp-attachments/#developers)

 [Support](https://wordpress.org/support/plugin/wp-attachments/)

## Description

WP Attachments enhances the download experience and file management in WordPress.
It automatically displays attachments in your posts and pages, so you don’t need
to manually insert download links.
 Easily attach, unattach, or reattach files directly
from the media library.

**Key Features:**
 – 🤖 Automatically displays attachments after post content – 
ℹ️ Backend metabox for managing attachments – 🔃 Quick Attach, Unattach, and Reattach
actions in the Media Library – 🔢 Download counter with anti-spam and logged-in 
user filtering – 🧑‍💻 Developer hooks and filters for customization – 🛍️ WooCommerce
compatible – 🎨 Five icon packs to choose from – 📜 Supports posts, pages, and custom
post types – 🎢 Customizable themes (title, date, size, caption, and more)

[Video Overview](https://www.youtube.com/watch?v=J7gf0hxl_z8)

### Contributions

 * Part of [WPGov.it](http://www.wpgov.it), providing open source solutions for 
   Italian Public Government websites.
 * Thanks to the Italian community [Porte Aperte sul Web](http://www.porteapertesulweb.it)
   for beta testing and ideas.
 * Metabox based on [IJ Post Attachments](https://wordpress.org/plugins/ij-post-attachments/)
 * Some icons by [Yusuke Kamiyamane](http://p.yusukekamiyamane.com/).

## Screenshots

 * [[
 * The generated attachment list
 * [[
 * Simple and intuitive options
 * [[
 * Demo from [www.sanpellegrinoterme.gov.it](http://www.sanpellegrinoterme.gov.it)
 * [[
 * Backend metabox
 * [[
 * Attach, unattach, and reattach files in the Media screen

## Installation

 1. Install via the WordPress.org plugin directory or upload the files to your server.
 2. Activate the plugin. To customize, go to **Settings  WP Attachments**.
 3. While editing a post, page, or custom post type, you’ll see a new metabox for managing
    attachments. Additional features are available in the Media Library: Attach, Reattach.

## FAQ

### How can I hide the attachment list for a specific page?

In the edit screen, use the plugin’s metabox to disable the automatic listing by
checking **Disable** at the bottom right.

### How can I avoid double listing?

You don’t need to insert file links manually. When you upload a file, it’s automatically
assigned to the content and displayed by WP Attachments. Just close the media popup
after uploading.

### How can I reorder files?

Drag and drop attachments in the WP Attachments metabox or Media Popup while editing.

### Developer Filters

WP Attachments includes many filters for developers:

 * **wpatt_list_html** — Filter the entire list output (`$html`)
 * **wpatt_before_entry_html** — Filter single entry output before tag parsing (`
   $html`)
 * **wpatt_after_entry_html** — Filter single entry output after tag parsing (`$
   html`)
 * **wpatt_accepted_formats** — Filter which files are shown (`$mime`)

**Examples:**

    ```
    `php
    ```

function my_custom_function( $html ) {
 // Alter final HTML return $new_html; } 
add_filter( ‘wpatt_list_html’, ‘my_custom_function’ ); `

    ```
    `php
    ```

function my_custom_function( $mime ) {
 // Only show PDFs in the list return $mime
== ‘application/pdf’; } add_filter( ‘wpatt_accepted_formats’, ‘my_custom_function’);`

## Reviews

![](https://secure.gravatar.com/avatar/75134204f23d1efab7132b632225fcb8b5170bdc4da6c7303a7c6f0286fe89da?
s=60&d=retro&r=g)

### 󠀁[Ottimo! Aggiornamento?](https://wordpress.org/support/topic/ottimo-aggiornamento/)󠁿

 [baritono](https://profiles.wordpress.org/baritono/) October 1, 2023

E’ un fantastico plugin, con tutta la sua semplicità. Metto 5 stelle con la speranza
che l’autore lo vorrà aggiornare. Perché ad esempio, ogni volta che aggiorno un/
a pagina/articolo gli allegati si attivano automaticamente, anche se prima erano
disattivati. Sarebbe meglio averli disattivati in default.

![](https://secure.gravatar.com/avatar/fda8a9480f6a1c3d3f269c266faf9fea24945c953f15266564a4cc446a9fbac8?
s=60&d=retro&r=g)

### 󠀁[Plugin is not working anymore](https://wordpress.org/support/topic/plugin-is-not-working-anymore-8/)󠁿

 [orangeletter2](https://profiles.wordpress.org/orangeletter2/) May 17, 2023

The plugin is abandoned by the original developer and lacks functionality. It does
not work anymore.

![](https://secure.gravatar.com/avatar/a3d9229e01f5d040be9637a126f5c3d090cc06048b0e60a65109734e90006356?
s=60&d=retro&r=g)

### 󠀁[give the box a class so that it’s styleable](https://wordpress.org/support/topic/give-the-box-a-class-so-that-its-styleable/)󠁿

 [rebelord](https://profiles.wordpress.org/rebelord/) August 5, 2022

also I’d love an option not to show the list at all in frontend – i would use it
only for unattaching in the backend. A zip-all-attachments download would be nice.
And as mentioned, images in the list should be shown as thumbnails. Also there is
a bug – when I edit the post and then try to unattach, it wants to reload and leave
the post unsaved. Ajax would suit better.

![](https://secure.gravatar.com/avatar/c499b086e15ee97f3f124feb5e6a1a31c017222a819fe35f8a15dcdd1f1f4017?
s=60&d=retro&r=g)

### 󠀁[Simple Yet Effective](https://wordpress.org/support/topic/simple-yet-effective-67/)󠁿

 [renpub](https://profiles.wordpress.org/renpub/) February 24, 2022

I tried over a dozen other plugins in order to display a simple list of PDFs which
the user can upload and display on a page. I was relieved to finally find WP Attachments
worked as expected and was simple to set up. Php 8 update, if needed, would be great
and compatibility with page builders and ease of CSS customisation are always welcome
features. Thank you for your work which is much appreciated.

![](https://secure.gravatar.com/avatar/8cf6bfb5609fd210003bbe033fd0a85ec9a8a577be9e715c4ff63b81f7a80495?
s=60&d=retro&r=g)

### 󠀁[Great functionality, not so great code](https://wordpress.org/support/topic/great-functionality-not-so-great-code/)󠁿

 [valebubble](https://profiles.wordpress.org/valebubble/) December 1, 2021

This plugin is simple but very focused and achieves what it needs to. That said,
the underlying code is messy and at times poorly written. For example, the attachments
div has no class or id so you can’t target it with css. It forces its style using
the “style” attribute which is pretty bad for customizability. I had to use a filter
and wrap it in another div just to have a class I could target with custom CSS. 
Another big issue: in the admin options, I am not able to use a custom template 
for the attachment title. Selecting the “Custom” option does nothing because the
plugin: – Uses a script HTML tag to load jQuery from an external CDN, in the middle
of the page. This is not the Wordpress standard way of loading jQuery (or any script
at all) and can potentially cause many issues. – Attempts to use the “$” variable
instead of using “jQuery”. This causes an error (TypeError: $ is not a function)
that blocks the execution of javascript and prevents the options from working correctly.
So if the plugin works for you out-of-the-box, that’s great. If you need to adapt
it somehow, be aware that the code is very hard to work with.

![](https://secure.gravatar.com/avatar/eb0fc748ae4a637172fa16fcecc04de6e16ba78a5271ea301302ec5960f1bc0f?
s=60&d=retro&r=g)

### 󠀁[Ottimo Plugin!](https://wordpress.org/support/topic/ottimo-plugin-260/)󠁿

 [lombino](https://profiles.wordpress.org/lombino/) September 20, 2021

Bravo!!

 [ Read all 42 reviews ](https://wordpress.org/support/plugin/wp-attachments/reviews/)

## Contributors & Developers

“WP Attachments” is open source software. The following people have contributed 
to this plugin.

Contributors

 *   [ Marco Milesi ](https://profiles.wordpress.org/milmor/)

“WP Attachments” has been translated into 6 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/wp-attachments/contributors)
for their contributions.

[Translate “WP Attachments” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-attachments)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/wp-attachments/), check
out the [SVN repository](https://plugins.svn.wordpress.org/wp-attachments/), or 
subscribe to the [development log](https://plugins.trac.wordpress.org/log/wp-attachments/)
by [RSS](https://plugins.trac.wordpress.org/log/wp-attachments/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 5.3.4 2026-03-14

 * Minor fixes and improvements.

#### 5.3 2026-02-02

 * Better permission handling
 * Redesigned settings screen

#### 5.2.1 2026-01-19

 * Minor fixes and improvements.

#### 5.2 2025-06-09

 * Fixed regression with images (thanks @reesher + @steeltape for feedback)
 * Added option to enable/disable for specific custom post types (completely or 
   only frontend)
 * Other minor fixes and improvements.

#### 5.1 2025-05-25

 * Date placeholders in attachment templates now use the WordPress date format setting(`
   Settings > General > Date Format`) for better localization and consistency.
 * Improved templating: You can now use WordPress date formatting in your custom
   templates, and templating settings are more flexible and reliable.
 * Other minor fixes and improvements.
 * Major code refactoring for improved stability and maintainability
 * Significant performance improvements
 * Enhanced security throughout the plugin
 * Improved admin capabilities and permission handling
 * Brand new metabox for easier attachment management
 * Refreshed admin columns for better overview and usability

#### 5.0.12

 * Latest stable release

#### 5.0.6 2023-02-15

 * Compatibility check
 * Security fixes
 * Minor changes

#### 5.0.4 2021-10-20

 * Compatibility check
 * Linked development workflows on [GitHub](https://github.com/WPGov/wp-attachments)
 * Minor changes

#### 5.0 2020-11-28

 * WooCommerce compatibility: add files to client orders
 * Major improvements and technical changes
 * Rewritten add_media popup with custom behavior
 * Removed old translation files, now using translate.wordpress.org
 * Minor changes

#### 4.4.2 2020-04-29

 * Minor improvements

#### 4.4.1 2020-02-20

 * Compatibility check

#### Version 4.4 18/11/2017

 * **Fixed** critical bug for missing icons in WP 4.9
 * Some problems may occur in previous WP versions for icons. Please update!

#### Version 4.3.6 10/01/2017

 * **Tested** with WP 4.7
 * **Fixed** php warning in custom post types with capabilities mapped

#### Version 4.3.4 06/07/2016

 * 4.6 compatibility check

#### Version 4.3.3 02/04/2016

 * Fixed bug in metabox date
 * Tested with WP 4.5

#### Version 4.3.2 19/02/2016

 * Fixed php notice error when debug active

#### Version 4.3.1 18/02/2016

 * Auto exclusion of dropdown if attachments < 2

#### Version 4.3 23/12/2015

 * Added option to show a dropdown for ordering
 * Various improvements and bugfix
 * Added support for translate.wordpress.org

#### Version 4.2 02/08/2015

 * Added developer functions and filters
 * Minor improvements
 * ReadMe changes (FAQS added)

#### Version 4.1.2 6/07/2015

 * Added es_ES translations by Joaquín Alejandro Duro Arribas
 * ReadMe changes

#### Version 4.1.1 1/06/2015

 * Tested with latest beta version
 * Readme changes

#### Version 4.1 26/04/2015

 * **Added** option to exlude logged-in users from download counter
 * **Fixed** “extended” template
 * Minor bugfixes
 * Minor readme.txt changes

#### Version 4.0.2

 * Correct bug of 404 error when file title contains special characters (download
   counter only)
 * Minor improvements

#### Version 4.0.1

 * Fixed download error 404 for some permalinks when counter enable

#### Version 4.0

 * New and better metabox
 * Added download counter function
 * Added icon themes
 * Added multiple schemes
 * Redesigned options
 * Performance improvements (2x faster)
 * Minor improvements

#### Version 3.7 05/03/2015

 * Added filter and option to restrict the plugin to single and page views
 * Minor performance improvements
 * Fixed wrong version in settings panel
 * Better style for attachments list

#### Version 3.6.1 28/02/2015

 * Added check for password protected posts

#### Version 3.6 28/02/2015

 * Improved performance
 * Improved metabox (faster & nicer)
 * Improved option panel
 * Added opton to deactivate the plugin on certain pages

#### Version 3.5.6 21/10/2014

 * **Fixed** css conflict with italian schools WordPress theme “pasw2015”

#### Version 3.5.5 05/09/2014

 * **Added** plugin icon
 * **Added** serbian translation sr_RS
 * readme.txt changes

#### Version 3.5.4 26/07/2014

 * **Fixed** possible conflict with other plugins (ex. Members)
 * **Fixed** missing translation of “Update” button in the options panel (world-
   wide)

#### Version 3.5.3 20/07/2014

 * **Added** Brazilian Portuguese translations by Henrique Avila Vianna

#### Version 3.5.2 15/07/2014

 * **Fixed** add media button not being displayed when no file attached
 * **Fixed** metabox not showing up for add-new “admin” pages
 * **Upgraded** uploader to be the same as WordPress’ integrated
 * **Improved** add media button style to exactly match the WordPress’ standard

#### Version 3.5.1 12/07/2014

 * **Tested** and working on WordPress 4.0 (beta)

#### Version 3.5 09/07/2014

 * Added **unattach** link in media admin page
 * Added **unattach** link in page/post/cpt editor
 * **Improved** back-end metabox
 * **Improved** capability handling for attach/reattach/unattach functions
 * **Improved** some variables handling
 * **Added** function to check if a file doesn’t exist and must skip filesize calculation(
   in order to avoid front-end errors)

#### Version 3.4 08/07/2014

 * Added **reattach** link in media admin page
 * Added **attach** link for unattached file in media admin page

#### Version 3.3 28/03/2014

 * **Added** option to open files in a new tab [in Settings -> WP Attachments]
 * **Fixed** conflict with “Members” plugin causing the metabox appearing in its
   options page
 * **Added** an “eye” icon in the editor metabox showing that the file will be listed
   front-end

#### Version 3.2.3 26/03/2014

 * **Solved** conflict with some newsletter plugins by addind code for avoiding 
   the attachments list if the given post id is null

#### Version 3.2.2 12/03/2014

 * Added support for **MP3**, **ODT**, **ODS**
 * Changed size text for small files: now showing “< 1KB” instead of “n B”
 * Better compatibility for Internet Explorer

#### Version 3.2.1 03/03/2014

 * Added wp_enqueue_style for loading css style
 * Performance improved

#### Version 3.2 03/03/2014

 * New localization system. English & Italian already translations included
 * New back-end metabox. That’s in beta, but i’m sure you will like it!
 * Better option page

#### Version 3.1.4 4/11/2013

 * Fixed missing ‘Backend.php’ (this function will be available in the next versions(
   3.2+)

#### Version 3.1.3 27/10/2013

 * Another bugfix

#### Version 3.1.2 27/10/2013

 * Fixed a bug causing content not to be loaded in some cases

#### Version 3.1.1 19/10/2013

 * List title is now hidden correctly

#### Version 3.1 15/09/2013

 * **Fixed** missing icon for images
 * **Added** option to exclude images from being listed
 * **Improved** settings page layout

#### Version 3.0.4 24/08/2013

 * **Readme** minor changes

#### Version 3.0.3 23/08/2013

 * **Improved** Css appearance

#### Version 3.0.2 23/08/2013

 * **Fixed** activation error: unespected output – 1 charater

#### Version 3.0.1 22/08/2013

 * **Fixed** missing external shortcode rendering
 * **Fixed** reduntant css code
 * **Improved** loop
 * List header doesn’t show up anymore for empty attachments

#### Version 3.0 22/08/2013

 * **Added** Css for showing icons
 * **Added** file size
 * **Added** attachment data
 * **Added** options panel

#### Version 2.0 04/07/2013

 * First functional release. Enjoy!

#### Version 1.0 07/01/2012

 * First Release

## Meta

 *  Version **5.3.4**
 *  Last updated **3 weeks ago**
 *  Active installations **3,000+**
 *  WordPress version ** 4.4 or higher **
 *  Tested up to **6.9.4**
 *  Languages
 * [English (US)](https://wordpress.org/plugins/wp-attachments/), [Italian](https://it.wordpress.org/plugins/wp-attachments/),
   [Spanish (Chile)](https://cl.wordpress.org/plugins/wp-attachments/), [Spanish (Colombia)](https://es-co.wordpress.org/plugins/wp-attachments/),
   [Spanish (Mexico)](https://es-mx.wordpress.org/plugins/wp-attachments/), [Spanish (Spain)](https://es.wordpress.org/plugins/wp-attachments/),
   and [Spanish (Venezuela)](https://ve.wordpress.org/plugins/wp-attachments/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/wp-attachments)
 * Tags
 * [attachments](https://wordpress.org/plugins/tags/attachments/)[ClassicPress](https://wordpress.org/plugins/tags/classicpress/)
   [file](https://wordpress.org/plugins/tags/file/)[list](https://wordpress.org/plugins/tags/list/)
   [media](https://wordpress.org/plugins/tags/media/)
 *  [Advanced View](https://wordpress.org/plugins/wp-attachments/advanced/)

## Ratings

 4.5 out of 5 stars.

 *  [  33 5-star reviews     ](https://wordpress.org/support/plugin/wp-attachments/reviews/?filter=5)
 *  [  2 4-star reviews     ](https://wordpress.org/support/plugin/wp-attachments/reviews/?filter=4)
 *  [  3 3-star reviews     ](https://wordpress.org/support/plugin/wp-attachments/reviews/?filter=3)
 *  [  3 2-star reviews     ](https://wordpress.org/support/plugin/wp-attachments/reviews/?filter=2)
 *  [  1 1-star review     ](https://wordpress.org/support/plugin/wp-attachments/reviews/?filter=1)

[Add my review](https://wordpress.org/support/plugin/wp-attachments/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/wp-attachments/reviews/)

## Contributors

 *   [ Marco Milesi ](https://profiles.wordpress.org/milmor/)

## Support

Issues resolved in last two months:

     1 out of 1

 [View support forum](https://wordpress.org/support/plugin/wp-attachments/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://www.paypal.me/milesimarco)