Skip to content

Instantly share code, notes, and snippets.

Embed
What would you like to do?
Code snippets for the Yoast SEO canonical output
<?php
/********* DO NOT COPY THE PARTS ABOVE THIS LINE *********/
/* Change the canonical link for the shop page
* Credit: Scott Weiss of somethumb.com
* Yoast Doc: https://developer.yoast.com/features/seo-tags/canonical-urls/api/
* Last Tested: Jan 25 2017 using Yoast SEO 6.0 on WordPress 4.9.1
*/
add_filter( 'wpseo_canonical', 'yoast_seo_canonical_change_woocom_shop', 10, 1 );
function yoast_seo_canonical_change_woocom_shop( $canonical ) {
if ( !is_shop() ) {
return $canonical;
}
return get_permalink( woocommerce_get_page_id( 'shop' ) );
}
<?php
/********* DO NOT COPY THE PARTS ABOVE THIS LINE *********/
/* Remove Yoast SEO Canonical From All Pages
* Credit: Yoast Team
* Yoast Doc: https://developer.yoast.com/features/seo-tags/canonical-urls/api/
* Last Tested: Jun 16 2017 using Yoast SEO 4.9 on WordPress 4.8
*/
add_filter( 'wpseo_canonical', '__return_false' );
<?php
/********* DO NOT COPY THE PARTS ABOVE THIS LINE *********/
/* Remove Yoast SEO Canonical From Individual or Multiple Items
* Credit: Yoast Team
* Yoast Doc: https://developer.yoast.com/features/seo-tags/canonical-urls/api/
* Last Tested: Jun 16 2017 using Yoast SEO 4.9 on WordPress 4.8
*********
* DIFFERENT POST TYPES
* Post: Change 123456 to the post ID
* Page: Change is_single to is_page and 123456 to the page ID
* Custom Post Type: Change is_single to is_singular and 123456 to the 'post_type_slug'
Example: is_singular( 'cpt_slug' )
*********
* MULTIPLE ITEMS
* Multiple of the same type can use an array.
Example: is_single( array( 123456, 1234567, 12345678 ) )
* Multiple of different types can repeat the if statement
*/
add_filter( 'wpseo_canonical', 'yoast_remove_canonical_items' );
function yoast_remove_canonical_items( $canonical ) {
if ( is_single ( 123456 ) ) {
return false;
}
/* Use a second if statement here when needed */
return $canonical; /* Do not remove this line */
}
<?php
/********* DO NOT COPY THE PARTS ABOVE THIS LINE *********/
/* Remove Yoast SEO Canonical From Search Pages Only
* Credit: Yoast Team
* Yoast Doc: https://developer.yoast.com/features/seo-tags/canonical-urls/api/
* Last Tested: Jun 16 2017 using Yoast SEO 4.9 on WordPress 4.8
*/
add_filter( 'wpseo_canonical', 'yoast_remove_canonical_search' );
function yoast_remove_canonical_search( $canonical ) {
if( is_search() ) {
return false;
} else {
return $canonical;
}
}
<?php
/********* DO NOT COPY THE PARTS ABOVE THIS LINE *********/
/* Add trailing slash to all Yoast SEO canonicals
* Credit: Unknown
* Yoast Doc: https://developer.yoast.com/features/seo-tags/canonical-urls/api/
* Last Tested: Oct 25 2019 using Yoast SEO 12.3 on WordPress 5.2.4
*/
add_filter( 'wpseo_canonical', 'yoast_seo_canonical_slash_add' );
function yoast_seo_canonical_slash_add( $canonical_url ) {
return trailingslashit( $canonical_url );
}
<?php
/********* DO NOT COPY THE PARTS ABOVE THIS LINE *********/
/* Remove trailing slash from all Yoast SEO canonicals
* Credit: Unknown
* Yoast Doc: https://developer.yoast.com/features/seo-tags/canonical-urls/api/
* Last Tested: Oct 25 2019 using Yoast SEO 12.3 on WordPress 5.2.4
*/
add_filter( 'wpseo_canonical', 'yoast_seo_canonical_slash_remove' );
function yoast_seo_canonical_slash_remove( $canonical_url ) {
return untrailingslashit( $canonical_url );
}
@amboutwe
Copy link
Author

amboutwe commented Sep 9, 2019

This is not the proper place to request support. Please check out our extensive Knowledge Base or visit the free support forum. If you require further support, upgrading to our premium version provides you with access to our support team.

@campaignupgrade
Copy link

Is the first example wrong? There's no $canonical_url variable in the wpseo plugin.

@amboutwe
Copy link
Author

@campaignupgrade The example is correct. The $canonical_url is a local variable for the custom function.

Bonus: Last tested date has been updated as I verified it worked today. Plus I added another snippet to remove the trailing slash for those that might need to do the opposite. Renamed the snippets to better align with what the code does.

@campaignupgrade
Copy link

Ah I see. If it's not pulling an already-defined varaible like $canonical it's just a local variable and it replaces whatever the output of generate_canonical().

@campaignupgrade
Copy link

campaignupgrade commented Oct 25, 2019

I'm looking for a clean way to replace the base_url of all my non-production sites with my production base_url. Unfortunately it doesn't look like I can override the individual subfunctions involved, so would a pregex_replace( $canonical ) approach be the only option?

I'm short on time and haven't thoroughly tested this, but it's working so far:

/**
* Set canonical URLs on non-production sites to the production URL
* Stops bots from indexing
* @link https://gist.github.com/amboutwe/2aa7dcc9a38986e11fac68c7306cc091
*/

add_filter( 'wpseo_canonical', function( $canonical ) {

  if( 'https://example.com' ==  get_option( 'home' ) ) {
    return $canonical;
  }

  $canonical = preg_replace('#//[^/]*/#U', '//example.com/', trailingslashit( $canonical ) );
  return $canonical;
});

@marouane91
Copy link

I have a page that is generated only in php !

So Is there a way to add a custom canonical or title/description tags for this specific page ?

Any help would be much appreciated ?

@amboutwe
Copy link
Author

amboutwe commented Jan 2, 2020

This is not the proper place to request support. Please check out our extensive Knowledge Base or visit the free support forum. If you require further support, upgrading to our premium version provides you with access to our support team.

@viniciusmiranda22
Copy link

Hi, does anyone knows how can I fix this? Somes slashes BEFORE my canonicals started to appear on all pages like the image below:

Captura-de-Tela-2020-06-21-às-18 02 56

@amboutwe
Copy link
Author

@viniciusmiranda22 As mentioned above, this is not the proper place to request support. Please check out our extensive help section or visit the free support forum. If you require further support, upgrading to our premium version provides you with access to our support team.

@frontend-coder
Copy link

yoast_seo_canonical_change_woocom_shop - dont work

@amarilindra
Copy link

@amboutwe

Canonical links and rel="prev" and rel="next" are removed on pages with "noindex" meta tag. Is there any way to force add them?

@ghaydtner
Copy link

When I go to an URL like myblog.com/blog/mypost/?what-is-my-canonical that has a query string on it, the canonical will be set to myblog.com/blog/mypost/?what-is-my-canonical.
In my eyes, the best canonical here would be myblog.com/blog/mypost/.
Is there a way to get rid of query strings for canonicals for blog posts?

@Suny-ticket
Copy link

Can we remove canonicals for only one post type (any specific)?
I am creating custom canonicals but Yoast gives me another canonical also, I want to replace canonical for that post-type generated by Yoast, not for other post types & pages.

@amboutwe
Copy link
Author

amboutwe commented Jan 5, 2023

@Suny-ticket Yes, the remove_post.php is for a single post, but that can be adjusted to be wider (all content matching specific criteria) depending on your needs. These are just a few examples so you or your developer have a starting point for the customization.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment