Title: Disable Media Pages Author: joppuyo Published: December 31, 2020 Last modified: August 4, 2025 --- Search plugins ![](https://ps.w.org/disable-media-pages/assets/icon-256x256.png?rev=2653576) # Disable Media Pages By [joppuyo](https://profiles.wordpress.org/joppuyo/) [Download](https://downloads.wordpress.org/plugin/disable-media-pages.4.0.0.zip) * [Details](https://wordpress.org/plugins/disable-media-pages/#description) * [Reviews](https://wordpress.org/plugins/disable-media-pages/#reviews) * [Installation](https://wordpress.org/plugins/disable-media-pages/#installation) * [Development](https://wordpress.org/plugins/disable-media-pages/#developers) [Support](https://wordpress.org/support/plugin/disable-media-pages/) ## Description Completely disable “attachment” pages created by WordPress. By default, WordPress creates a page for each of your attachments. This is can be undesirable because of two reasons: ### Search engine optimization Attachment pages don’t have any content, except an image, so they provide little value and can negatively affect your SEO because they are so-called [thin content](https://developers.google.com/search/docs/advanced/guidelines/thin-content). Even worse, attachment pages may in some cases rank higher than your actual content pages which leads to a poor user experience. ### Reserved slugs Attachment pages can accidentally reserve slugs on your site. Let’s say you upload an image named **contact.jpeg**, an attachment page `https://example.com/contact` is automatically created. If you then try to create a page named **Contact**, the URL for that page will be `https://example.com/contact-2` which isn’t that great. ### How it works This plugin works by automatically setting all attachment slugs to an unique id, so they won’t conflict with your pages. If an attachment page is accessed, the plugin will set a 404 status code and display the “page not found” template. You can also mangle any existing attachment slugs so they won’t cause any issues in the future. ### WP CLI support The plugin supports WP CLI. #### Mangle existing attachment slugs ``` wp disable-media-pages mangle ``` #### Restore attachment slugs ``` wp disable-media-pages restore ``` ### Note for WordPress 6.4 WordPress 6.4 includes [a new feature](https://make.wordpress.org/core/2023/10/16/changes-to-attachment-pages/) that allows you to disable attachment pages. However, this feature redirects attachment pages to the file URL instead of returning a 404 error. To completely disable attachment pages, you should use this plugin instead. The WP 6.4 feature also does not fix the issue where attachment pages reserve slugs for pages. Also, there is not user interface to enable or disable media pages, they are automatically disabled for new sites but remain enabled for existing sites. Because of these issues, I recommend you to use this plugin instead of the built- in feature. The plugin will be updated in the foreseeable future, at least until attachment pages are completely removed from WordPress core and older WordPress versions are no longer in use. ### Thanks Special thanks to Greg Schoppe for [his research](https://gschoppe.com/wordpress/disable-attachment-pages/) and inspiration that helped a lot with developing this plugin. ### Support the plugin Maintaining a WordPress plugin is a lot of work. If you like the plugin, please consider rating it on [WordPress.org](https://wordpress.org/support/plugin/disable-media-pages/reviews/#new-post). You can also support me on [GitHub sponsors](https://github.com/sponsors/joppuyo). Thank you! If you are interested, you can also check out my other WordPress plugins: * [Disable Customizer](https://wordpress.org/plugins/customizer-disabler/) * [Disable Drop Cap](https://wordpress.org/plugins/disable-drop-cap/) * [ACF Image Aspect Ratio Crop](https://wordpress.org/plugins/acf-image-aspect-ratio-crop/) ## Installation 1. Install the plugin from your WordPress dashboard 2. Activate the Disable Media Pages plugin via the plugins admin page 3. From now on, media pages will be disabled and new media items uploaded in the library will get unique id slugs ## FAQ ### How to mangle existing attachment slugs? Go to the **Settings** ▸ **Disable Media Pages** ▸ **Mangle existing slugs**. This will show you a wizard to mangle existing attachment slugs. ### Why not just use Yoast SEO? It has a feature to redirect attachment pages to parent First of all, not everyone uses Yoast SEO. More importantly, while Yoast SEO can fix the duplicate content issue, it does not help with issue of media files reserving slugs for pages. ### What if I want to redirect attachment pages to parent page instead? Instead of displaying a 404 HTTP error, some people recommend you to redirect attachment pages to the parent page instead. I think this can be a good short-term solution if the attachment pages have been indexed by Google and you want to preserve SEO ranking for these URLs. There’s a plenty of plugins on the plugin directory that let you to do that. In my opinion returning the 404 error is the correct long-term solution and if you are launching a new site, it’s best to simply disable these pages so they won’t ever end up in Google index. ### What kind of unique id is used? The unique id is an UUIDv4, without dashes. ### Can I restore the attachment page slugs after mangling? Yes, this functionality is available in version 1.1.0. The attachment slug restoration tool allows you to restore the attachment slugs back to ones based on the attachment title. ### Can I find this plugin on GitHub? Yes, check out the [GitHub repository.](https://github.com/joppuyo/disable-media-pages) ## Reviews ![](https://secure.gravatar.com/avatar/582c7c80f7f08f5b75ac53a338149fe8a7df7f2910cba2093929729972fce9ff? s=60&d=retro&r=g) ### 󠀁[An essential tool](https://wordpress.org/support/topic/an-essential-tool-13/)󠁿 [xoruna](https://profiles.wordpress.org/xoruna/) January 20, 2025 The plugin works great and is very useful for any wordpress site. ![](https://secure.gravatar.com/avatar/41f38ad1fe5ca573acf77c66a3cb2e6af8801e090e36d54e282996b3b5ba688b? s=60&d=retro&r=g) ### 󠀁[Excellent plugin](https://wordpress.org/support/topic/excellent-plugin-9335/)󠁿 [kotoedo](https://profiles.wordpress.org/kotoedo/) October 4, 2024 This is a simple to use plugin that does exactly what it says. Recommend! ![](https://secure.gravatar.com/avatar/6400d61bec7cf7b741fca62fefc723eb85c32be6a87363b08082f63d25fc1795? s=60&d=retro&r=g) ### 󠀁[A life saver!](https://wordpress.org/support/topic/a-life-saver-86/)󠁿 [MTC](https://profiles.wordpress.org/magictrashcan/) July 13, 2024 Needed the media page slugs for content pages but the pictures, being named after the pages, blocked all the required slugs. This plugin did the trick just fine! 2800 slugs renamed without errors and the desired urls are usable again rightaway. Great stuff! ![](https://secure.gravatar.com/avatar/e685f0b1f8b9792cebaf1b06b7926ef0f73e58248cb916fa79bde4fcaeabb0d5? s=60&d=retro&r=g) ### 󠀁[YES! Solved my problem. No more added numbers -2](https://wordpress.org/support/topic/yes-solved-my-porblem/)󠁿 [mksmpl](https://profiles.wordpress.org/mksmpl/) July 8, 2024 I create a lot of small business service + location pages. I was using two other plugins, one to duplicate a page, and lpagery to create the pages themselves. This is a lot of images and a lot of data. I was not able to have my base service urls as I wanted them. Wordpress kept putting a number at the end (/service-3/). Nothing I tried would let me remove that number unless I changed my slug altogether (which for internal linking was a lot of work) I scoured the internet, tried changing and reseting my permalink structure, clearing my cache, etc and nothing worked. I came across this plugin and in 30 seconds it fixed my problem. HIGHLY reccomend if you’re have a lot of similar pages and images. This is a life saver! ![](https://secure.gravatar.com/avatar/3e36841289d0ed1c105795e363dae4be09cc7b001def28f913b4b748d74403ec? s=60&d=retro&r=g) ### 󠀁[Absolutely amazing plugin. THANK YOU!!](https://wordpress.org/support/topic/absolutely-amazing-plugin-thank-you/)󠁿 [Gary Gordon](https://profiles.wordpress.org/garymgordon/) October 8, 2023 Well, this is exactly what I needed. I needed to release all of the URLs that were created for the attachment pages, and remove the links to the attachment pages. All I can say is wow!! Great job. I wish this was a feature built into WordPress. This plugin made me a “happy camper” today!! ![](https://secure.gravatar.com/avatar/8f969f81798dcffd2fc2d8f7edaeba9fe15abf945d50aef6deaa994b4ad257de? s=60&d=retro&r=g) ### 󠀁[Working well](https://wordpress.org/support/topic/working-well-140/)󠁿 [atresall](https://profiles.wordpress.org/atresall/) May 12, 2023 Working well! [ Read all 17 reviews ](https://wordpress.org/support/plugin/disable-media-pages/reviews/) ## Contributors & Developers “Disable Media Pages” is open source software. The following people have contributed to this plugin. Contributors * [ joppuyo ](https://profiles.wordpress.org/joppuyo/) “Disable Media Pages” has been translated into 9 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/disable-media-pages/contributors) for their contributions. [Translate “Disable Media Pages” into your language.](https://translate.wordpress.org/projects/wp-plugins/disable-media-pages) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/disable-media-pages/), check out the [SVN repository](https://plugins.svn.wordpress.org/disable-media-pages/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/disable-media-pages/) by [RSS](https://plugins.trac.wordpress.org/log/disable-media-pages/?limit=100&mode=stop_on_copy&format=rss). ## Changelog ### 4.0.0 (2025‐08‐04) * Breaking change: Minimum supported WordPress version is now 6.0 and the minimum PHP version is now 8.0. This is because wp-browser, which is used for testing no longer supports PHP 7. If you are using an older version of WordPress or PHP, please use the last 3.x version of this plugin. * Fix: Tested in WP 6.8 ### 3.1.3 (2024‐07‐25) * Fix: Tested in WP 6.6 ### 3.1.2 (2024‐04‐04) * Fix: Tested in WP 6.5 ### 3.1.1 (2024‐03‐26) * Fix: Removed unnecessary debugging statements * Fix: improve readme formatting ### 3.1.0 (2024‐03‐24) * Feature: Add WP CLI support ### 3.0.5 (2023‐11‐09) * Update readme ### 3.0.4 (2023‐11‐09) * Fix: WordPress 6.4 compatibility. * **Note for WordPress 6.4** * WordPress 6.4 includes [a new feature](https://make.wordpress.org/core/2023/10/16/changes-to-attachment-pages/) that allows you to disable attachment pages. However, this feature redirects attachment pages to the file URL instead of returning a 404 error. To completely disable attachment pages, you should use this plugin instead. The WP 6.4 feature also does not fix the issue where attachment pages reserve slugs for pages. * Also, it seems like this feature does not work as intended, because it will disable attachment pages only for users who are logged in. Anonymous users will still be able to access attachment pages. You can follow the progress of this issue on [WordPress Trac](https://core.trac.wordpress.org/ticket/59866). * Also, there is no user interface to enable or disable media pages, they are automatically disabled for new sites but remain enabled for existing sites. * Because of these issues, I recommend you to use this plugin instead of the built- in feature. The plugin will be updated in the foreseeable future, at least until attachment pages are completely removed from WordPress core and older WordPress versions are no longer in use. ### 3.0.3 (2023‐09‐26) * Fix: Improved randomness in UUIDv4 generation ### 3.0.2 (2023‐08‐10) * Fix: Tested in WP 6.3 ### 3.0.1 (2023-06-15) * Fix: Fix typo ### 3.0.0 (2023-06-15) * Fix: Tested in WordPress 6.2 * Breaking change: Dropped support for WordPress 5.0, WordPress 5.1, and PHP 7.0. The Debian version in the Docker images is so old it no longer works properly and crashes the build. This makes it very difficult to run tests. New minimum PHP version is 7.1 and minimum WordPress version is 5.2. ### 2.0.3 (2022-12-11) * Fix: Fix typo. Thanks to [porg](https://github.com/joppuyo/disable-media-pages/issues/34) for noticing this! ### 2.0.2 (2022-10-31) * Fix: Test in WP 6.1 ### 2.0.1 (2022-07-26) * Fix: small update to readme ### 2.0.0 (2022-07-25) * Breaking change: fixed how the plugin hooks into the `redirect_canonical` action. Because the plugin didn’t return a value from this filter, this caused the plugin to change default WordPress behaviour (eg. https://example.com/index.php did not redirect to https://example.com/ like with a normal WordPress installation). In this version the filter returns the value which restores this WordPress default functionality. I’m making this a major release because it changes the plugin behaviour, so I recommend testing your site in a development or staging environment before updating your production site. For more information, see [this support thread](https://wordpress.org/support/topic/index-php-bug-breaks-wp-rocket/). ### 1.3.0 (2022-06-03) * Feature: Improved slug generation logic. Now the plugin checks the slug is in UUIDv4 format before generating a new slug. This prevents slugs from changing when saving a post. ### 1.2.3 (2022-05-25) * Fix: Test in WP 6.0 ### 1.2.2 (2022-02-05) * Fix: Add missing localization string * Fix: Minor readme updates * Fix: Optimize acceptance test database size ### 1.2.1 (2022-01-28) * Fix: Fix typo ### 1.2.0 (2022-01-28) * Feature: Improved plugin code structure * Feature: Add donate link * Fix: Readme update * Fix: Fix issue where the plugin was unable to mangle slugs that contained UUID along with some other text ### 1.1.3 (2022-01-28) * Fix: Bump supported WordPress version to 5.9 * Fix: Readme updates * Fix: Add automated test for slug restore functionality ### 1.1.2 (2022-01-19) * Fix: Remove debugging statements * Fix: Fix typo in readme ### 1.1.1 (2022-01-06) * Fix: Minor fix to the icon ### 1.1.0 (2022-01-06) * Feature: Add a tool for restoring media slugs back to the original ones * Feature: Add status page for the plugin which tells you if you have attachments without unique ids * Fix: Add menu for the plugin under Settings on the WordPress dashboard * Fix: Update plugin icon ### 1.0.8 (2021-07-24) * Fix: Bump supported WordPress version to 5.8 * Fix: Update dependencies ### 1.0.7 (2021-06-14) * Fix: Update dependencies * Fix: Update FAQ * Fix: Tweak icon ### 1.0.6 (2021-06-09) * Fix: Fix issue with deployment ### 1.0.5 (2021-06-09) * Fix: Bump tested up to @ 5.7 * Fix: Add acceptance tests ### 1.0.4 (2021-01-02) * Change: Add icon ### 1.0.3 (2020-12-31) * Fix: Change required WordPress version correctly to 5.0 * Fix: Optimize autoloader ### 1.0.2 (2020-12-31) * Change: Release on WordPress plugin directory * Change: Changes to internal plugin structure * Fix: Make plugin translatable * Fix: Load JavaScript and CSS only on plugin page ### 1.0.1 (2020-12-19) * Fix: WordPress 5.6 compatibility, thanks [@tnottu](https://github.com/tnottu) ### 1.0.0 (2020-09-26) * Initial release ## Meta * Version **4.0.0** * Last updated **9 months ago** * Active installations **10,000+** * WordPress version ** 6.0 or higher ** * Tested up to **6.8.5** * PHP version ** 8.0 or higher ** * Languages * [Chinese (Taiwan)](https://tw.wordpress.org/plugins/disable-media-pages/), [English (US)](https://wordpress.org/plugins/disable-media-pages/), [Finnish](https://fi.wordpress.org/plugins/disable-media-pages/), [Spanish (Chile)](https://cl.wordpress.org/plugins/disable-media-pages/), [Spanish (Colombia)](https://es-co.wordpress.org/plugins/disable-media-pages/), [Spanish (Ecuador)](https://es-ec.wordpress.org/plugins/disable-media-pages/), [Spanish (Mexico)](https://es-mx.wordpress.org/plugins/disable-media-pages/), [Spanish (Spain)](https://es.wordpress.org/plugins/disable-media-pages/), [Spanish (Venezuela)](https://ve.wordpress.org/plugins/disable-media-pages/), and [Swedish](https://sv.wordpress.org/plugins/disable-media-pages/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/disable-media-pages) * Tags * [attachment](https://wordpress.org/plugins/tags/attachment/)[disable](https://wordpress.org/plugins/tags/disable/) [hide](https://wordpress.org/plugins/tags/hide/)[media](https://wordpress.org/plugins/tags/media/) [remove](https://wordpress.org/plugins/tags/remove/) * [Advanced View](https://wordpress.org/plugins/disable-media-pages/advanced/) ## Ratings 5 out of 5 stars. * [ 17 5-star reviews ](https://wordpress.org/support/plugin/disable-media-pages/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/disable-media-pages/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/disable-media-pages/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/disable-media-pages/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/disable-media-pages/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/disable-media-pages/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/disable-media-pages/reviews/) ## Contributors * [ joppuyo ](https://profiles.wordpress.org/joppuyo/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/disable-media-pages/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://github.com/sponsors/joppuyo)