Canonical URLs

If you need to customize the canonical URLs that appear in your metadata or in your XML sitemap you have multiple options:

  • Custom Pages
  • Metadata Field
  • Template Overrides

# Custom Pages

To add support for a custom page with Canonical URL that does not exist in other URL-Enabled Sections, toggle the global plugin setting for "Enable Custom Pages" and a new section will appear on your Sitemaps management page that allows you to add custom URLs to the XML sitemap.

# Metadata Field

To allow overrides to the Canonical URL of a page for an individual entry, enable the "Canonical URL" setting when you set up your metadata field. This will display an additional Canonical URL option for your Metadata field that can be updated by content managers.

# Template Overrides

WARNING

Overriding Canonical URLs in your templates breaks the relationship with XML Sitemaps and the awareness Sprout SEO has about Canonical URL overrides. To add Custom URLs in a supported way to your XML Sitemaps see the documentation on Custom Pages.

To override the canonical meta value on any given page in your templates, use the craft.sproutSeo.meta tag and set the canonical attribute to the appropriate URL:

{% do craft.sproutSeo.meta({
    canonical: customUrl,
}) %}

{% sproutseo 'optimize' %}

# Canonical Override Field

If you need to override the canonical meta tag at the Entry level, you can do so by creating a custom field for your override and updating the value in your template.

If your Canonical override field handle has the value of canonicalOverrideFieldHandle, you would add the following snippet to the pages where you wanted to allow overrides:

{% do craft.sproutSeo.meta({
canonical: entry.canonicalOverrideFieldHandle
}) %}