Set up a custom canonical URL

Learn how to configure a custom canonical URL to ensure search engines index the correct version of your site.

A canonical URL tells search engines which version of your content should be treated as the primary one. This is especially important when your site can be accessed through multiple domains or URL paths.

What the canonical URL setting does

Framer automatically generates key SEO tags in your site's <head> based on your connected domain. When you connect and publish a domain through Framer, these tags are updated to reflect that domain.

If your site is served through a reverse proxy and the domain is not directly connected to your Framer project, Framer cannot determine the correct domain automatically. In this case, SEO tags may default to your project's .framer.website domain, which can affect how search engines index your content.

The Canonical URL setting allows you to manually specify the primary URL that search engines should use.

Configure a custom canonical URL

Follow these steps to set up a canonical URL:

  1. Open your project.

  2. Go to Settings > Domains.

  3. Scroll to the bottom of the page.

  4. Locate the Canonical URL field.

  5. Enter the URL you want search engines to treat as the primary version of your site.

Use one of the following formats:

Scenario

Example

Your domain only serves your Framer site

https://example.com

Your Framer site is hosted within a larger website structure

https://example.com/blog

Verify the configuration

After setting your canonical URL:

  1. Republish your site.

  2. Wait for publishing and optimization to complete.

  3. Open any page on your site.

  4. View the page source in your browser.

  5. Locate the <link rel="canonical"> tag.

  6. Confirm that it points to your specified URL instead of the default .framer.website domain.

Why canonical URLs matter

Canonical URLs help search engines understand which version of your content should be indexed and displayed in search results. This can help prevent duplicate content issues and ensure that SEO signals are attributed to the correct domain.

A canonical URL tells search engines which version of your content should be treated as the primary one. This is especially important when your site can be accessed through multiple domains or URL paths.

What the canonical URL setting does

Framer automatically generates key SEO tags in your site's <head> based on your connected domain. When you connect and publish a domain through Framer, these tags are updated to reflect that domain.

If your site is served through a reverse proxy and the domain is not directly connected to your Framer project, Framer cannot determine the correct domain automatically. In this case, SEO tags may default to your project's .framer.website domain, which can affect how search engines index your content.

The Canonical URL setting allows you to manually specify the primary URL that search engines should use.

Configure a custom canonical URL

Follow these steps to set up a canonical URL:

  1. Open your project.

  2. Go to Settings > Domains.

  3. Scroll to the bottom of the page.

  4. Locate the Canonical URL field.

  5. Enter the URL you want search engines to treat as the primary version of your site.

Use one of the following formats:

Scenario

Example

Your domain only serves your Framer site

https://example.com

Your Framer site is hosted within a larger website structure

https://example.com/blog

Verify the configuration

After setting your canonical URL:

  1. Republish your site.

  2. Wait for publishing and optimization to complete.

  3. Open any page on your site.

  4. View the page source in your browser.

  5. Locate the <link rel="canonical"> tag.

  6. Confirm that it points to your specified URL instead of the default .framer.website domain.

Why canonical URLs matter

Canonical URLs help search engines understand which version of your content should be indexed and displayed in search results. This can help prevent duplicate content issues and ensure that SEO signals are attributed to the correct domain.

FAQ

  • Do I need to configure a canonical URL if my domain is connected directly to Framer?

    In most cases, no. Framer automatically generates the correct canonical tags when your domain is connected and managed through Framer.

  • When should I use a custom canonical URL?

    Use a custom canonical URL when your site is served through a reverse proxy or when Framer cannot automatically determine the public domain of your content.

  • Can I use a path instead of a root domain?

    Yes. If your Framer site is hosted within a subdirectory of a larger website, enter the full path, such as https://example.com/blog.

Updated