Changes to Attachment Pages  ## Metadata - Author: [[Make WordPress Core]] - Full Title: Changes to Attachment Pages - Category: #articles - Document Note: --- tags: - #WordPress - #AttachmentPages - #WebDevelopment Author: Make WordPress Core (Courtney Robertson) Source: WordPress.org Reference: https://make.wordpress.org/core/2023/10/16/changes-to-attachment-pages/ date created: 2025-08-23 00:00 --- # Title: WordPress 6.4 — Changes to Attachment Pages ## Table of Contents: - [📚 References](#-references) - [📝 Summary](#-summary) - [📖 Main Content](#-main-content) - [🗒️ Notes](#️-notes) - [📖 References](#-references-1) - [🗣️ Paraphrase](#-paraphrase) - [📰 Newsletter](#-newsletter) - [✅ Action Items](#-action-items) - [🧪 Hypotheses](#-hypotheses) - [📊 Methodology](#-methodology) - [❓ Questions](#-questions) - [🔮 Future Research](#-future-research) - [💡 Implications](#-implications) - [🧠 Learning Styles Assessment](#-learning-styles-assessment) - [📊 Accessibility Assessment](#-accessibility-assessment) - [🌍 DEIB (Diversity, Equity, Inclusion, and Belonging) Assessment](#-deib-diversity-equity-inclusion-and-belonging-assessment) - [✅ Logical validity](#-logical-validity) - [🔍 DARVO Analysis](#-darvo-analysis) - [🔍 SEO Evaluation](#-seo-evaluation) - [🎯 Conclusion](#-conclusion) ### References: - Make WordPress Core: Changes to attachment pages — https://make.wordpress.org/core/2023/10/16/changes-to-attachment-pages/ ## 📝 Summary: WordPress 6.4 introduced a core change to eliminate low-value attachment pages from new sites. Historically, every uploaded media item generated a dedicated attachment page, which often provided little user value yet was indexed by search engines. As of 6.4: - New installations have attachment pages disabled by default and redirect to the media file URL. - Existing sites retain current behavior after upgrade. - A new option, wp_attachment_pages_enabled, allows administrators to toggle behavior (1 = enabled; 0 = disabled). When disabled, the admin link changes from “View attachment page” to “View Media File.” ## 📖 Main Content: WordPress attachment pages were an artifact of legacy behavior: each media upload automatically created a dedicated singular page. While occasionally useful (e.g., for themed galleries or custom templates), most sites didn’t enrich these pages, leading to thin content indexed in SERPs. WordPress 6.4 re-centers practical UX and SEO: - New sites default to disabling attachment pages and redirecting to the file URL. - Upgraded sites preserve current behavior to avoid breaking expectations or theme logic. - Administrators can explicitly control behavior via a single option: wp_attachment_pages_enabled. Practical implications: - SEO: Reduces thin-content URLs and confusion in search results. - UX: Users land on the intended media resource rather than empty templates. - Governance: Offers a clear, reversible switch for developers and site owners. Implementation notes: - Toggle via WP-CLI: wp option set wp_attachment_pages_enabled 0|1 - When disabled, WordPress updates UI labels in the Media Library to match the behavior (“View Media File”). Personal insight: This is a principled shift toward sensible defaults: protect novices from SEO pitfalls, preserve backward compatibility for established sites, and provide a clean, auditable configuration path. It aligns with WordPress’s long-term security, performance, and UX goals. ### 🗒️ Notes - Background - Prior to 6.4, every upload had an attachment page. - These pages commonly lacked meaningful content and sometimes ranked in search. - Change in 6.4 - Introduces database option: wp_attachment_pages_enabled. - New sites: default 0 (disabled), redirect to media file URL. - Existing sites on upgrade: set to 1 (enabled) to avoid disruption. - Admin controls - Toggle via: - WP-CLI: wp option set wp_attachment_pages_enabled 0|1 - Small plugin (admin bar toggle). - Admin options page (less recommended): wp-admin/options.php - UI impact - When disabled: “View attachment page” becomes “View Media File.” - Rationale - Reduce thin content and search confusion. - Maintain backward compatibility. - Provide explicit, testable configuration. ## 📖 References: - Make WordPress Core announcement: https://make.wordpress.org/core/2023/10/16/changes-to-attachment-pages/ ## 🗣️ Paraphrase: - Original: “As of WordPress 6.4, attachment pages for new WordPress installations are fully disabled.” - Paraphrase: Starting in WordPress 6.4, fresh installs no longer generate attachment pages at all. - Original: “Until WordPress 6.4 was released, WordPress created attachment pages by default... sometimes even rank in search results, leading to bad results for users and site owners.” - Paraphrase: Before 6.4, WordPress automatically made a page for each upload. Despite offering little value, those pages could still appear in search, creating a poor experience for users and site owners. ## 📰 Newsletter: Big Core change alert: WordPress 6.4 quietly retired default attachment pages for new sites. Why you’ll love it: - No more thin attachment-page URLs cluttering your search results. - Users get what they expect—straight to the media file. - Site owners retain control with a single toggle: wp_attachment_pages_enabled. For existing sites, nothing breaks—your current behavior stays. New installs default to disabled and redirect to the file URL. Want to flip it? - WP-CLI: wp option set wp_attachment_pages_enabled 0|1 - Or add a tiny admin toggle plugin if you’re feeling clicky. Elsewhere in WP land: keep learning modern web dev (Core Web Vitals still matter), highlight community wins (new contributor sessions are thriving), and check out fresh plugins for media handling and SEO hygiene. Tip: Audit your sitemap for attachment URLs and adjust redirects to keep SERPs squeaky clean. Read the announcement on WordPress.org’s Core blog under “Changes to attachment pages.” ## ✅ Action Items: Strategic prompt for alignment with your Developer Advocate and OSPO trajectory: - Purpose: Analyze how each article informs open-source advocacy, contributor onboarding, and education within WordPress, while advancing transparency, inclusivity, and sustainable funding narratives. - Use this prompt for future articles: - Mission alignment: Explain how the change impacts the open-source ecosystem’s usability, governance, and contributor workflows. - Contributor pathways: Identify opportunities to mentor contributors (docs updates, testing, triage, accessibility checks). - Education design: Outline learning objectives and a micro-curriculum (beginner → advanced) for devs and non-devs to adopt the change. - OSPO lens: Describe policy implications, default-safety decisions, and measurable outcomes (SEO health, support load, content quality). - Sustainability: Note how the change reduces maintenance overhead or improves long-term quality. - DEIB and transparency: Propose inclusive docs, clear change logs, and multilingual resources. - Activation plan: Provide talk abstracts, workshop outlines, and sample repos demonstrating toggles, redirects, and audits. - Metrics: Define KPIs (reduced thin-URL indexation, improved CTR, fewer support tickets). Application to this article: - Mission: Sensible defaults reduce harm for new users; preserves compatibility for existing sites. - Contributor opportunities: Update docs, write tests for redirects, create CLI how-tos, translate materials. - Curriculum: Lesson 1—What are attachment pages? Lesson 2—6.4 changes. Lesson 3—CLI toggles. Lesson 4—SEO audits. Lesson 5—Accessibility implications. - OSPO: Shows governance balancing backwards compatibility and UX; simple config improves auditability. - Sustainability: Fewer low-value URLs → less support noise and SEO cleanup. ## 🧪 Hypotheses: - H1: Disabling attachment pages by default lowers the number of thin pages indexed by ≥80% on new sites within 60 days. - H2: Sites with disabled attachment pages experience improved organic CTR to primary content pages by ≥5%. - H3: Support requests related to “strange image pages in Google” decline by ≥30% post-6.4 for new installs. - H4: Providing a visible UI toggle increases admin awareness and intentional configuration by ≥25%. ### 📊 Methodology: - Data sourc - Summary: As of WordPress 6.4, attachment pages for new WordPress installations are disabled by default. This change was made because attachment pages often don't provide valuable information and can lead to poor search results for users and site owners. Existing sites will still have attachment pages enabled, but administrators can choose to disable them by setting the wp_attachment_pages_enabled option to 0. The option can be changed via WP CLI, a plugin, or the admin options page. When attachment pages are disabled, the admin link "View attachment page" will be changed to "View Media File." - URL: https://make.wordpress.org/core/2023/10/16/changes-to-attachment-pages/ As of WordPress 6.4, attachment pages for new WordPress installations are fully disabled. Until WordPress 6.4 was released, WordPress created attachment pages by default for every attachment uploaded. On the vast majority of sites, these attachment pages don’t add any meaningful information. They do, however, exist, get indexed by search engines, and sometimes even rank in search results, leading to bad results for users and site owners. [This change](https://core.trac.wordpress.org/ticket/57913) introduces a `wp_attachment_pages_enabled` database option to control the attachment pages’ behavior: * On existing sites, the option is set to `1` on upgrade, so that attachment pages continue to work as is. * For new sites, the option is set to `0` by default, which means attachment pages are redirected to the attachment URL. * Sites administrators who want to enable or disable the attachment pages can set the option to `1` or `0`, respectively. When attachment pages are disabled, the admin link “View attachment page” changes to “View Media File”. #### Setting the option ##### Via WP CLI To test this change or if you just want to change it on a live site, you can use [WP CLI](https://wp-cli.org/). You would do so like this: ``` wp option set wp_attachment_pages_enabled 0|1 ``` ##### Via a plugin Another option is to use [this small plugin](https://core.trac.wordpress.org/ticket/57913#trac-change-41-1694675313719907) built by [@costdev](https://profiles.wordpress.org/costdev) during the development process that allows enabling the attachment pages through an admin bar item. ##### Via the admin options page While this is not usually recommended, you can visit `wp-admin/options.php` on your site, search for `wp_attachment_pages_enabled` and change the option right there., Changes to Attachment Pages, Make WordPress Core, 01hcwxxgya4zz7kng8nrgm88yc.