Note: You are viewing the documentation for Version 4View Version 3 Docs

Link to file (e.g. PDF) instead of Attachment page

WordPress by default will link to an Attachment page for any Media returned as a search result. Many themes do not have useful templates for Media and very often it makes sense to link directly to the file itself instead.

This snippet will customize your search results template to link directly to Media files instead of an Attachment page.

All hooks should be added to your custom SearchWP Customizations Plugin.

// Link directly to Media files instead of Attachment pages in search results
function my_search_media_direct_link( $permalink, $post = null ) {
if ( ( is_search() || doing_action( 'wp_ajax_searchwp_live_search' )
|| doing_action( 'wp_ajax_nopriv_searchwp_live_search' ) )
&& 'attachment' === get_post_type( $post ) ) {
$permalink = wp_get_attachment_url( $post->ID );
return esc_url( $permalink );
add_filter( 'the_permalink', 'my_search_media_direct_link', 10, 2 );
add_filter( 'attachment_link', 'my_search_media_direct_link' );
view raw functions.php hosted with ❤ by GitHub
Fix keyword search on your site. No coding required!

Now you can utilize all of the content that's gone unrecognized by native WordPress keyword search instantly with SearchWP

Get SearchWP