In short. Import HubSpot redirects with the official CSV template, check field mappings, and select the overwrite option when updating matching original URLs.
Definition: As of October 2026, importing redirects into HubSpot means adding or updating URL redirect rules from a CSV file in the URL Redirects settings. A URL redirect routes requests from an original address to a destination address.
Key facts
- HubSpot's bulk upload guide limits each import to 500 redirects and each uploaded URL to 140 characters.
- HubSpot's sample CSV includes source and destination columns alongside redirect settings.
- HubSpot's redirect documentation requires URL Redirects permission and a domain connected to and hosted in HubSpot.
Which columns belong in the import template?
The official template contains these headers and this example row, reproduced from the file:
original url,redirect to,redirect type,redirect style,priority,match query strings,ignore trailing slash,ignore protocol,disable if page exists,note
/contact-us,/contact-us-team,STANDARD,301,999999,TRUE,TRUE,TRUE,TRUE,
The endpoint columns are original url, for the address being redirected, and redirect to, for its destination. The sample uses STANDARD for redirect type, a numeric redirect style, and uppercase TRUE or FALSE for matching settings. Its note cell can be empty, as this row shows. The sample's priority and matching values are example settings to review before reuse.
HubSpot's public import guide does not identify a complete mandatory-column schema or specify which settings can be omitted.
The field descriptions accept a full URL or path for the original address; an external destination needs a full URL including http:// or https://. HubSpot defines 301 as permanent, the default style for new redirects.
How is the CSV uploaded?
HubSpot's upload instructions place Import under Settings > Content > Domains & URLs > URL Redirects. After file selection, Next opens field mapping. Each spreadsheet column must map to its intended HubSpot redirect field; dropdown menus allow corrections.
For updates, Overwrite existing redirects with same original URL enables replacement of matching redirects. The next screen accepts an explanatory note and offers a separate option to overwrite existing notes. The final import button completes the upload.
How are errors and imported rules checked?
The import troubleshooting instructions state that a file error blocks the entire import, including correctly formatted rows. Notifications > Import Failure > Download Error List provides the error spreadsheet.
For review, HubSpot's management documentation allows searches by all or part of an original URL or destination. Actions > Edit opens an individual rule; Export downloads redirects as CSV.
Related terms
- How do I create a HubSpot URL redirect?
- How do I create a pattern-based URL redirect in HubSpot?
- How do I resolve conflicting redirects in HubSpot?
- How do I control query strings in HubSpot redirects?
FAQ
Can I update existing redirects with an import?
Yes. Select Overwrite existing redirects with same original URL during field mapping, as described in HubSpot's import guide.
Why might a redirect take time to work?
HubSpot's redirect guide allows up to 48 hours for propagation and suggests clearing your browser cache when a redirect behaves unexpectedly.
Sources
- HubSpot, "Create and manage URL redirects", 21 May 2026
- HubSpot, "Bulk upload URL redirects", 23 September 2025
- HubSpot, "sample-redirect-import.csv", undated
Check how a page reads to answer engines. Open the GEO score analyzer