Canonical Attachments
Get more information from analytics and higher rankings by utilizing canonical http headers in htaccess for non image media attachments like pdfs.
Consider an alternative
Canonical Attachments shows warning signs in 2026 — compare the alternatives below before installing. It runs on 300+ sites, is rated 3.7/5 and was last updated 1 year ago, and scores 38/100 on our health check.
- Small user base (300+ active installs)
- Very few reviews so far
- No update in over a year
- Only tested up to WordPress 6.8 (latest is 7.1)
How does it stack up?
Side-by-side on installs, updates, ratings & support
Daily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where Canonical Attachments stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| attachments | #17 |
| canonical | #5 |
| canonical tags | #5 |
| canonicalize | #1 |
| >100 |
Version adoption
Share of active sites per release.
Rating breakdown
★★★★★★★★★★ 3.7 from 3 reviews
About Canonical Attachments
From the official readme · v1.8Description
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
Installation
This section describes how to install the plugin and get it working.
- Search for “Canonical Attachments” from the Add Plugins page and click install
- Alternatively: Upload
canonical-attachements.zipto the/wp-content/plugins/directory - Activate the plugin through the ‘Plugins’ menu in WordPress
- Enjoy!
Frequently asked questions
Will this work on wordpress installs that do not use apache server
No. This plugin only works for wordpress installations on servers running apache, as it is depending on writing the rules to the .htaccess file.
Do I have to manually create the .htaccess file in the uploads directory?
The plugin will need to be able to write to the directory in order to work. When you install the plugin, it will create the .htaccess file with the proper permissions.
What happens to the .htaccess file if I uninstall the plugin
As there may be other items in the htaccess file that are important, uninstalling this plugin does not remove the .htaccess file. You will have to do this manually. It is important to note that uninstalling this plugin does not remove any content of the htaccess file. If you wish to remove canonicals, you should use the bulk editor or manually edit the .htaccess file using the editor option. When you remove by manually editing the htaccess file, the associations will still exist in the wordpress database as an option for that media item, but since they are not in the .htaccess file, they will…
Why is there an option to edit the .htaccess directly?
In some instances there may be files outside of wordpress’s database that you wish to canonical, so we wanted to make it accessible for adding those items. The most likely case for this would be if you migrated to wordpress and manually moved a directory or files into the uploads folder vs. uplaoding through wordpress. Future iterations of this plugin might include a way to better manage non wordpress linked media files.
Some of my media files aren’t attached to a post, what happened?
This has nothing to do with our plugin, but occurs when you upload media files when you are not editing / creating a post. The wordpress library has a filter for unattached media items, and you can attach them manually there. Our editor does not require the media item be attached to a post, it just makes it possible to use the bulk feature to attach vs. having to do it one at a time. You can also use the post finder from the “attach media” option in our bulk editor.
Who built this awesome plugin?
This plugin was developed by the good folks at Hive Digital
Changelog
This version addresses a security vulnerability. Upgrade immediately.
1.8
- Testing with latest version of wordpress
- Testing with PHP 8.3
- Fixing warnings from PHP 8.3
- Changing author logo
- Thank you to @licuriciul for update/testing for latest versions
1.7
- Testing with latest version of wordpress
- Bug Fix .. thank you @bnovembit for pointing out the issues with return inside of if statement.
1.6
- Testing with latest version of wordpress
1.5
- Bug Fix .. thank you @dglingren for pointing out the return $post issues
- Updated screenshots to highlight new functionality
- Shortcut to plugin settings / options page
1.4
- Bug Fix .. thank you @philippmuenchen for pointing this out!
1.3
- Added options to filter the main canonical page
- Added options to attach/detach media to posts
Screenshots
For developers
Is this your plugin? Show off the numbers.
Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.
Best Canonical Attachments alternatives
All attachments plugins →
FAQ
Canonical Attachments: quick answers
Straight answers, pulled from live WordPress.org data.
Live data from WordPress.org · checked Sep 28, 2026
Is Canonical Attachments free?
Yes. Canonical Attachments is free to download and use from the official WordPress.org plugin directory.
Is Canonical Attachments safe to use in 2026?
Canonical Attachments shows warning signs in 2026 — compare the alternatives below before installing. It runs on 300+ sites, is rated 3.7/5 and was last updated 1 year ago, and scores 38/100 on our health check.
How many websites use Canonical Attachments?
Canonical Attachments is active on 300+ WordPress websites and has been downloaded 7,847 times since it launched in January 2017. It was downloaded 128 times in the last 30 days.
Does Canonical Attachments work with WordPress 7.1?
Canonical Attachments is officially tested up to WordPress 6.8.10, while the latest release is 7.1.2. It may still work, but try it on a staging site first.
When was Canonical Attachments last updated?
The latest version, 1.8, was released on August 25, 2025 (1 year ago).
Who makes Canonical Attachments?
Canonical Attachments is developed and maintained by hivedigital.
What are the best alternatives to Canonical Attachments?
The most popular alternatives to Canonical Attachments are Export media with selected… (40K+ installs), File Upload Types by WPForms (40K+ installs) and Lightbox with PhotoSwipe (20K+ installs).
Powered by PageForge
Want thousands of pages that rank like these? Build them in an afternoon.
This directory runs on the same engine as PageForge. Turn any spreadsheet, CSV or API into thousands of fast, SEO-ready WordPress pages — with schema, internal links and AI-written copy baked in.
- CSV, Google Sheets & API data sources
- AI content, schema & internal links per page
- Works with Elementor, Gutenberg, Yoast & Rank Math
- Free on WordPress.org — no credit card
