Skip to content

Bulk upload URL redirects

Last updated: September 23, 2025

Available with any of the following subscriptions, except where noted:

In Domain & URL settings, you can bulk upload a CSV file If you have multiple redirects to add or update using the URL redirects tool.

You can use this sample CSV file as a template for your import file. Learn more about the URL redirect options for fields on this spreadsheet. 

Please note:
  • A maximum of 500 redirects can be added or updated in bulk at one time. 
  • URLs uploaded to URL redirects in bulk can have a maximum of 140 characters. 

Upload URL redirects

  1. In your HubSpot account, click the settings settings icon in the top navigation bar.
  2. In the left sidebar menu, navigate to Content > Domains & URLs.
  3. Click the URL Redirects tab.
  4. In the top right, click Import.
  5. Click choose a file to select a file from your computer or drag and drop your file into the upload field. Then click Next.
  6. Review your field mappings to confirm your spreadsheet values are mapped to the correct fields. Click the URL redirect fields in HubSpot dropdown menus and select different redirect fields, if needed.

The map fields step is displayed when importing URL redirects. Review the mapped fields and then click the Next button in the bottom right.

  1. If you're updating existing mappings in bulk, select the Overwrite existing redirects with same original URL checkbox at the bottom of your field mappings. Then click Next.
  2. On the Add note page, enter a note about why you're adding these URL redirects.
  3. If you want to replace the existing notes for URL redirects matching those in your import, select the Overwrite existing note for URL redirects with a note checkbox.
  4. When finished, click Import [#] redirects to complete the import.

The add note step is displayed when importing URL redirects. Add a note about why the URL redirects are being imported. A Overwrite existing note for URL redirects with a note checkbox is displayed. Click the Next button in the bottom right.

Troubleshoot URL redirect imports

If you encounter any errors when importing URL redirects in bulk, you'll receive a spreadsheet of the import errors in your account notifications.

  • In your HubSpot account, click the notification Notifications icon in the top navigation bar.
  • At the bottom of the Import Failure event, click Download Error List to download the file.

Please note: errors in your import file will prevent any redirects from being imported. This includes redirects in the same file that are formatted correctly. 

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.