Note: While our most popular guides have been translated into Spanish, some guides are only available in English.
Troubleshooting link issues

Most issues with links on Squarespace sites happen when there are errors with the linked URL. You can resolve many of these errors with the steps in this guide.

To learn about the different ways you can add links, visit Adding links to your site.

Common link issues

Here are some issues you may see with links on your site. Use the steps below to resolve them.

A link leads to login screen

If clicking a link or button leads to a login page, this means the link is leading to the editing area for your site. This usually happens when you used a URL that appears in a browser address bar when editing a page on your site. These links don't work for site visitors. This URL looks like this:

https://example.squarespace.com/config#/pages/blog

Visitors, or anyone who isn't logged into your site, will be brought to a login screen when they click this link because the URL has the "/config#/" slug, which only displays to you when you're editing.

To resolve this issue, follow the steps below. We recommend using the Content tab in the link editor to avoid these issues.

A link leads to the logged-in version of your site

If you click a link containing your built-in domain, you might see the logged-in version of your site. This happens when you’re already logged into your Squarespace account on the same browser. The browser sees that you’re still logged in, and will redirect you to the editing side of your site. 

If visitors access your site from your built-in URL, they won't see the logged-in version. Instead, they’ll see your site, with your built-in URL in the browser bar. If you have a custom domain, you can prevent visitors from using your built-in domain by hiding it from search engines.

A link leads to a "Page not found" or 404 error

If a URL has changed or contains a typo, links pointing to this broken URL may redirect visitors to a 404 error page. Revisit the links on your site and use the steps below to fix the issue.

While we recommend manually updating all outdated links, you can also set up URL redirects to point visitors to new pages.

A link leads to the wrong domain name

All Squarespace sites include a built-in domain, like example.squarespace.com. If a link directs to this URL, rather than your primary domain, reset this link by reselecting the page in the Content tab. Additionally, ensure that the domain you want to show in the browser address bar is set as your primary domain.

Note that your built-in domain will always show to you when you're editing your site as a security measure.

Links to imported content don't work

If you imported content containing links from another host, like WordPress or Blogger, there's a chance the older link structure doesn't match Squarespace's. You can resolve this by resetting older links using the Content tab instead of direct URLs.

You can also set up URL redirects to point visitors to new pages.

Fix broken external links

An external link connects to URLs outside of your site. You can resolve issues in these links by following these steps:

  1. Visit the page you want to link to and copy the URL from your browser's address bar.
  2. Test the URL in a private or incognito window to test it.
  3. Log into your site and go to the area containing the link. This could be a clickthrough URL, Button Block, text link, navigation link, or Cover Page.
  4. Open the link editor.
  5. Click the External tab. Paste the copied URL into the URL field.
  6. Click out of the link editor and save.
  7. In a private or incognito window, visit the page on your site with the link. Click the link to confirm it works correctly.

Fix broken content links

content link connects to other pages on your Squarespace site. You can set these up using the Content tab, rather than External link URL field. You can troubleshoot issues using these steps:

  1. Log into your site and go to the area containing the link. This could be a clickthrough URL, Button Block, text link, navigation link, or Cover Page.
  2. Open the link editor.
  3. Click the Content tab. Select the page you want to link. You can also click the drop-down arrows to link to collection items sorted by a category or tag. To link to an individual collection item, such as a blog post, use the External link method listed above.
  4. Click out of the link editor and save.
  5. In a private or incognito window, visit the page on your site with the link. Click the link to confirm it works correctly.
Note: To avoid link issues when you change the URL slug of a linked page, we recommend following these steps to reset the links.

Change how a link opens

To change how a link opens, go to the editing area where you added the link. This could be in a clickthrough URLButton Blocktext linknavigation link, or Cover Page.

  • Check Open in New Window to request that the browser opens this in a new tab.
  • To open the link in the same tab, leave Open in New Window unchecked.
  • You may need to scroll down to find this option if you're using the Content tab.

Squarespace doesn't support setting links to open in an entirely new window, as this can cause issues with a browser's pop-up blocker.

How the link opens is ultimately up to the visitor and how they use their browser. Even if a link is set to open in the same tab, visitors can open it in a new tab using shortcuts like holding while clicking the link.

Links in Gallery Blocks

In a Gallery Block, set clickthrough URL links to open in a new tab by checking the option in Design tab. This option applies to all images in the Gallery Block. 

  1. While editing the page, hover over the Gallery Block and click Edit
  2. Click the Design tab.
  3. Scroll down and check or uncheck Open Links in New Window.
  4. Click Apply to save your changes.

Fix broken anchor links

An anchor link, or “page jump,” is a special kind of link that direct visitors to specific areas on a page. Visit our guide for specific troubleshooting tips.

Was this article helpful?
2 out of 40 found this helpful
Troubleshooting link issues