Note: While our most popular guides have been translated into Spanish, some guides are only available in English.
Changing URL slugs

A URL slug is the exact address of a specific page or post on your site.

Squarespace automatically assigns a URL slug for each new page, post, or collection item based on its page title. For example, if you add a page titled "About," its automatic URL slug is http://www.yourdomain.com/about. You can manually change it by following this guide.

Using short, memorable URLs makes it easier for visitors to find and share your content.

URL slug formatting tips

When editing URL slugs, keep the following formatting requirements in mind:

Capitalization

  • URL slugs are all lowercase.
  • Any uppercase characters you enter when editing the URL will automatically change to lowercase.
  • If you or visitors enter any uppercase letters when trying to visit a page, your site's 404 error will display instead. To prevent this from happening, you can create 301 URL redirect, which sends visitors from an incorrect, capitalized URL to the uncapitalized version your site uses.

Character limits

  • URL slugs must be between 3 and 250 characters.
  • URL slugs can't include special characters other than dashes (-).
  • If you save a blog post or event before adding a title, the URL slug will be a random string of characters.

Reusing old URLs

URL slugs for live pages/posts can't match URL slugs for content in the trash can. To reuse a deleted page/post's URL slug, empty the trash can, or restore the deleted page/post, change its URL, and then delete it again so you can reuse the URL.

Reserved URL slugs

Squarespace reserves some URL slugs for internal parts of your site, meaning you'll see an error message if you try to use them for a page's URL. Reserved slugs include:

  • account
  • api
  • assets
  • auth
  • cart
  • checkout
  • commerce
  • config
  • debug
  • facebook
  • files
  • item
  • script
  • scripts
  • search
  • sharer
  • static
  • storage
  • universal

Avoid broken links after making any changes

If you change a page's URL slug, traffic won't automatically redirect to the new URL. If a visitor clicks or navigates to the old URL, they'll see the 404 error.

There are a few ways to prevent broken links after changing a URL slug:

Change a page URL

Page URLs are automatically set based on a page's title. To edit this URL, follow these steps:

  1. In the Home Menu, click Pages.
  2. Hover over the page title.
  3. Click the next to the title to open Page Settings.
  4. Update the URL Slug box in the Basic tab.
  5. Click Save.

url-slug.png

Change a blog post URL

Blog post URLs are set by the post's title and the default Post URL Format in Blogging Settings. 

To edit a blog post URL's slug:

  1. In the Home Menu, click Pages.
  2. Open a Blog Page.
  3. Click the post and click Edit.
  4. Click Settings to open the blog post editor.
  5. Click the Options tab.
  6. Enter a new URL slug in the Post URL box. Only the specific blog post's URL slug can be edited here. You can change the Blog Page's slug by following the steps above to change a page URL.

Set a default blog post URL format

To keep blog post URLs consistent, all post URLs publish in the same format. You can edit this format to include any combination of the post's title, creation year, month, date, and/or custom text.

To set the default blog post URL format:

  1. In the Home Menu, click Settings, and then click Blogging.
  2. Edit the Post URL Format using the variables below and any custom text.
  3. To delete a variable from a blog post (for example, YEAR), place your cursor to the right of the variable and press the Delete key.

Variables:

  • %t - The post title
  • %m - The creation month for the blog post
  • %d - The creation date (day of the month) for the blog post
  • %y - The creation year for the blog post
Note: If you added custom text, spaces between characters will appear as "%20." To avoid this formatting, replace spaces with dashes ("-").

posturlformat.jpg

Change a homepage URL

Your homepage always uses your site's primary domain, with no page slug after it. If you don't have a custom domain, your built-in domain displays instead. 

The URL Slug option disappears from Page Settings when you make a page your homepage. If you added a page slug before making a page your homepage, the URL using the original slug (like www.yoursite.com/example-page) will still direct to that page. To change this, make a different page your homepage temporarily, change the URL slug, then set the page back as your homepage.

Change an event URL

URLs for individual events are set by the Events Page URL followed by the event date and title. Edit an event URL by following these steps:

  1. In the Home Menu click Pages.
  2. Open an Events Page.
  3. Click an event and click Edit to open the event editor.
  4. Click the Options tab.
  5. Enter a new URL slug in the Event URL box. Only the specific event's URL slug can be edited here. You can change the Events Page's slug by following the steps above to change a page URL.
  6. Click Save.

Change a gallery image URL

Deeplink URLs, also called Post URLs, are unique URLs automatically assigned to images in many templates' Gallery Pages. These URLs take visitors directly to any image within a Gallery Page.

You can replace the automatically-generated slug for any image in a Gallery Page:

  1. In the Home Menu, click Pages.
  2. Open a Gallery Page.
  3. Hover over an image in the Gallery panel and click the to open the Image Editor.
  4. Click the Options tab.
  5. The assigned deeplink URL is in the Image URL box. Adjust this to change the slug.
  6. Click Save.

Change an Index URL

An Index displays the content from multiple subpages in one location. To change the URL for the Index landing page, ensure you edit the main Index:

  1. In the Home Menu, click Pages.
  2. Hover over the Index Page title.
  3. Click the next to the title.
  4. Update the URL Slug box in the Basic tab.
  5. Click Save.

open-index-page-settings.png

Tip: Each subpage has its own URL, called the direct URL. To change any of these, edit the subpage directly.

Change a product URL

Product URLs are set by the Product Page's URL followed by the product title. Edit a product's URL slug by following these steps:

  1. In the Home Menu, click Pages.
  2. Open a Product Page.
  3. Double click a product to open the product editor.
  4. Click the Options tab.
  5. Enter a new URL slug in the Product URL box.

Only the specific product's URL slug can be edited here. You can change the Product Page's slug by following the steps above to change a page URL.

Was this article helpful?
41 out of 141 found this helpful