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 Page 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 (or Page tab in navigation links) instead of direct URLs.

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

Fix broken web address links

An web address 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. Paste the URL in a Private or Incognito browser 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, navigation link, Cover Page action, or text link.
  4. Click the link icon or URL box, then click the gear icon to open the link editor.
  5. Click the Web Address tab. Paste the copied URL into the URL field.
  6. Click 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 page links

page link connects to other pages on your Squarespace site. You can set these up using the Page tab, rather than the Web Address 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, navigation linkCover Page action, or text link.
  2. Click the link icon or URL box, then click the gear icon to open the link editor.
  3. Click the Page tab. Click into the Search box and select the page you want to link.
  4. 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 Web Address tab mentioned above.
  5. Click Save.
  6. In a private or incognito window, visit the page on your site with the link. Click the link to confirm it works correctly.

Change how a link opens

To change how a Web Address or Page link opens, go to the editing area where you added the link. This could be a clickthrough URL, Button Block, navigation linkCover Page action, or text link.

  • Enable Open in New Window to request that the browser opens this in a new tab.
  • To open the link in the same tab, disable Open in New Window.

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.

Links in Gallery Blocks

Only the Grid Gallery Block supports opening clickthrough URLs in a new tab.

In a Grid 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 Grid Gallery Block.

  1. While editing the page, hover over the Grid 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?
6 out of 133 found this helpful
Troubleshooting link issues