WordPress plugin intelligence profile

Canonical Attachments

Get more information from analytics and higher rankings by utilizing canonical http headers in htaccess for non image media attachments like pdfs.

WP PlugIndex snapshot

Current directory snapshot

Tested up to WordPress 6.8
Current version1.8
WordPress coverageTested up to WordPress 6.8
Minimum stackWP 4.5.1 · PHP —
Directory statusactive
Last directory update25 Aug 20251y ago
Active installations300Adoption metric — not a quality score
WordPress.org rating3.7 / 5 from 3 ratings
Official packageDirect from WordPress.org

Repository metrics are context, not quality scores. Active installations measure adoption and can strongly reflect a plugin’s age and historical popularity. Ratings, recent updates and “Tested up to” metadata also do not guarantee modern code, error-free operation, security, feature completeness or suitability for a particular site. Why active installs don’t tell the whole story →

WP PlugIndex currently records Canonical Attachments version 1.8 as active, updated 1y ago and tested up to WordPress 6.8.

Overview

About this plugin

This plugin was developed to allow canonical tags as response headers to be created via htaccess for attachment files such as pdfs and docs.

The plugin:

  • Generates an htaccess file to manage the wp-content/uploads directory where these files are being uploaded
  • Updates the htaccess file with canonical tags which are delivered via a header when the attachment is called
  • Creates a dashboard where you can easily filter and find attachments without canonicals or that are not attached to a post.
  • Creates a dashboard where you can easily attach a file to its parent post (one at a time or in bulk) or manually add/remove a canonical tag for a file
  • Allows you to add a canonical url from the media file in the library or when you upload
  • Creates a dashboard to edit the.htacess file directly for the uploads directory in case there are additional files in the directory that were uploaded outside of wordpress (e.g. during a site migration)

The challenge: Analytics software such as Google Analytics, cannot track a user that enters a website via a pdf file in Google search results. Files cannot have a standard canonical tag added in the <head> and instead the canonical tag has to be added via an http header when the file is requested from the server. In order to accomplish this, we need to have an htaccess file listening for a request to that file, and then sending the header.

Expected outcome: PDF files and other attachments will be replaced in search results with the post or page counterparts, and we will be able to measure the traffic to those pages and provide calls to action for downloading the file, submitting contact forms, etc. Note: Canonical tags do not force a search engine to index one url vs. another, but act as a guideline/request to the search engine.

As long as the attachment content is similar to the canonical URL, you should have no problem encouraging the search engines to choose the correct version.

Future Features and Development

Based on the feedback, we hope to continue developing additional features to support user requests. Current future feature ideas include:

  • Automatic canonicalization of non-image files to attached post
  • Integration with non-apache servers
  • Canonical builder for non-wordpress media files
  • Option to bulk delete canonical associations and delete htaccess on uninstall
WordPress.org metadata

Plugin tags

Topics listed for this plugin in the WordPress.org directory.

  • canonical tags
  • attachments
  • canonicalize
  • pdf
Compatibility & maintenance

Compatibility & maintenance

Tested up to WordPress 6.8

Not yet marked as tested with WordPress 7.1. WordPress.org currently lists Tested up to 6.8.

Current WordPress releaseWordPress 7.1
WordPress.org Tested up to6.8
Minimum requirementsWordPress 4.5.1 · PHP not listed
Update activity25 Aug 20251y ago

“Tested up to” is directory metadata supplied by the plugin author. WP PlugIndex does not turn an older declaration into a claim that the plugin is incompatible.

Changes recorded by WP PlugIndex

Recent tracked changes

No tracked version or compatibility changes have been recorded by WP PlugIndex yet.

Tracking & source

WP PlugIndex tracks public WordPress.org directory metadata and records selected version, compatibility and availability changes as they are detected.

Plugin watchlist

Watch this plugin

Sign in to your WP PlugIndex account or create a free account. Free accounts can watch up to 5 plugins and see what changed.

Watch limit

Watchlist limit reached

You have reached your current active watch limit.