Create and manage URL redirects

With URL redirects, you can redirect traffic from any URL on a HubSpot-hosted domain to any other URL.  You can also set up rules to dynamically update the structure of URLs with flexible pattern redirects. To update URL redirects in bulk, learn how to upload redirects.

Before you get started

Before you begin working with this feature, make sure to fully understand what steps should be taken ahead of time, as well as the limitations of the feature and potential consequences of using it. 

Understand requirements

• To view URL redirects and export, a user must be a Super Admin or have URL Redirects permission with the View permission turned on. 
• To edit or delete URL redirects, a user must be a Super Admin or have the URL Redirects permission with the Publish permission turned on.

Understand limitations & considerations

• Published quotes can't be redirected from one domain to another. For example, if you host your quotes on www.website.com, but later redirect that domain to www.new-website.com, quotes that were hosted on the original domain won't be redirected and will instead become error pages.
• File URLs can't be redirected.
• HubSpot automatically encodes URLs with special characters. For example, the tool will automatically convert é into %C3%A9 when it's added.
• When a redirect isn't working as expected, you may need to clear your browser cache. It can take up to 48 hours for a redirect to propagate.

Add a new URL redirect

You can add a new standard or flexible URL redirect from any HubSpot-hosted domain to any other URL. 

1. In your HubSpot account, click the settings settings icon in the top navigation bar.
2. In the sidebar menu, navigate to the Tools section and click to expand Content. Then, select Domains & URLs.
3. On the Domains & URLs page, click the URL Redirects tab.
4. In the top right, click Add URL redirect.
5. In the right panel, select the Standard or Flexible redirect type. A standard redirect is used to redirect one URL to another. A flexible redirect updates URLs based on the way they're structured.
6. In the Original URL field, enter the full URL or URL path that you want to redirect.
7. In the Redirect to field, enter the URL of the page you want the original URL to redirect to. When redirecting to an external page that's not hosted on HubSpot, be sure to enter the full URL, including http:// or https:// (e.g., http://www.domain.com/name-of-page).
8. Click More options to customize advanced options for the URL redirect.
9. When you're finished configuring your redirect, click Add URL redirect.

View and manage URL redirects

You can search for specific redirects, apply filters, sort, and switch columns in the URL redirects table. You can also manage URL redirects, including editing, exporting, and deleting. 

View URL redirects

To search, filter, sort, and switch columns in the URL redirects table:

1. In your HubSpot account, click the settings settings icon in the top navigation bar.
2. In the sidebar menu, navigate to the Tools section and click to expand Content. Then, select Domains & URLs.
3. On the Domains & URLs page, click the URL Redirects tab.
4. To search URL redirects, in the search bar, enter a URL or part of a URL that exists in the Original URL or Redirect to field of an existing redirect. 
5. To filter URL redirects based on how they were created, click the Display dropdown menu and select an option:
   
   • Manual redirects: display redirects created by users.
   • System redirects: display redirects created automatically when the URL of a published page, blog, or blog post is updated. These redirects can't be edited.
6. To filter redirects created by a specific user, click the Created by dropdown menu and select the user.
7. To sort URL redirects in the table, click the column header you want to sort by.
8. To switch URL redirect columns at the top of the table, click Switch columns in the top right. In the dialog box, select the checkboxes next to the column options. You can select four columns at a time.

Manage URL redirects

You can edit and delete existing URL redirects. You can also export a CSV file of your redirects. 

To edit, delete, and export URL redirects:

1. In your HubSpot account, click the settings settings icon in the top navigation bar.
2. In the sidebar menu, navigate to the Tools section and click to expand Content. Then, select Domains & URLs.
3. On the Domains & URLs page, click the URL Redirects tab.
4. To edit a URL redirect, click the Actions dropdown menu, then select Edit. To bulk edit URL redirects, select the checkboxes next to the redirects that you want to edit, then click Edit at the top of the table.
5. To delete a URL redirect, click the Actions dropdown menu in the Actions column. Then select Delete. To bulk delete URL redirects, select the checkboxes next to the redirects that you want to delete, then click Delete at the top of the table.
6. To export URL redirects in a CSV file, click Export in the top right.

Customize URL redirects with advanced options

You can have more control over a redirect's behavior when using More options while creating or editing a URL redirect. 

To customize URL redirects with advanced options:

1. In your HubSpot account, click the settings settings icon in the top navigation bar.
2. In the sidebar menu, navigate to the Tools section and click to expand Content. Then, select Domains & URLs.
3. On the Domains & URLs page, click the URL Redirects tab.
4. To edit a URL redirect, click the Actions dropdown menu, then select Edit. To add a new redirect, learn more about adding a new URL redirect.
5. In the right panel, click More options to expand the options. 
6. Select from the following advanced options:
   • Redirect style: sets the conditions under which the URL will redirect.
     
     • Permanent (301): redirect one page URL to another URL. This is the default selection for new redirects.
     • Temporary (302): temporarily redirect one page to another URL. This type of redirect is often used to temporarily redirect traffic for website maintenance or a website redesign.
     • Proxy (305): redirect the content of your live page without changing the URL displayed on the visitor's web browser. This type of redirect is often used to share a file that's hosted on a specific directory outside your main site.
   • Priority: by default, new redirects are assigned the lowest priority. To customize this setting, clear the Assign lowest priority checkbox and enter a custom value.
   • If more than one redirect exists for the original URL, the redirect with the lowest priority will be applied. For example, if there are two URL redirects that apply to a URL - one with a priority of 100 and the other with a priority of 1 - the redirect with a priority of 1 would be applied. 
   • Match query strings: only redirect the page from the exact original URL entered. This means that if the original URL has any additional parameters, the redirect won't be applied. This option is not selected by default.
   • Ignore trailing slash: apply the redirect whether the original URL includes a forward slash / at the end or not. This option is selected by default.
   • Ignore protocol (HTTP or HTTPS): apply the redirect whether the original URL starts with http:// or https://. This option is selected by default.
   • Disable redirect if a page exists at the redirected URL: apply the redirect only when the original URL is unpublished. If the original URL is live, this redirect won't be applied. This option is not selected by default.
   • Note: explain why this URL redirect was created.
7. When you have edited your redirect's advanced options, click Update URL redirect or Add new redirect to apply your changes.