How to Bulk Upload URL Redirects in HubSpot

Managing large numbers of URL changes can be stressful, especially during site migrations or restructures. Using HubSpot, you can bulk upload URL redirects with a simple CSV file so you preserve SEO value, avoid broken links, and keep visitors on the right pages.

This how-to guide walks you step-by-step through preparing a CSV file, uploading your redirects, and reviewing results based strictly on the official HubSpot documentation.

Why Use HubSpot for Bulk URL Redirects?

When you change page URLs, remove content, or merge sections of your website, old links can quickly lead to 404 errors. With HubSpot bulk redirects, you can:

• Safely migrate from an old site structure to a new one.
• Redirect legacy URLs from other platforms into your HubSpot-hosted pages.
• Fix large batches of broken links in one upload instead of one at a time.
• Maintain search engine rankings and user experience.

This feature is ideal for marketers, developers, and agencies managing complex websites inside the HubSpot ecosystem.

HubSpot Requirements and Limits for Bulk Redirects

Before you begin, make sure your account and file meet the necessary conditions. HubSpot has specific rules you must follow for a successful bulk upload.

Domains and user permissions in HubSpot

• You must have at least one domain connected and set as a primary or secondary domain for website content.
• To add or edit URL redirects, your user must have the correct website or domain tools permissions in HubSpot.
• Redirects apply only to content hosted on connected domains managed inside HubSpot.

File format and size limits

• Your file must be a CSV (comma-separated values) file.
• Use UTF-8 encoding to avoid unexpected characters.
• HubSpot sets a maximum row limit per upload (see the latest limit on the official documentation page: HubSpot bulk upload URL redirects guide).
• Each row represents one redirect rule.

How to Prepare Your CSV for HubSpot Redirects

The bulk upload depends on a well-structured CSV. HubSpot expects specific column headings and clean URL formatting.

Required columns for HubSpot bulk redirects

At minimum, include these core columns in your CSV header row:

• original URL (or path to redirect from)
• redirected URL (destination path or full URL)

Depending on your needs, you can also include optional columns supported by HubSpot, such as:

• redirect type (for example 301 or 302)
• match type (exact match, prefix, or other types supported by HubSpot)
• priority (to control which rule wins if there are conflicts)
• note (internal description for your team)

Always refer to the official HubSpot documentation for the exact column names and accepted values, as these can evolve over time.

Formatting URLs correctly for HubSpot

• Use URL paths starting with a forward slash (for example, /old-page) when redirecting within the same domain.
• Use full URLs (for example, https://example.com/new-page) when redirecting to a different domain.
• Be consistent: do not mix trailing slash variants unless you have a specific reason.
• Avoid including query strings in the path unless you are deliberately matching that exact pattern.

Example row for a HubSpot CSV file

Here is a simple conceptual example of how a single redirect may look in the CSV:

• original URL: /old-blog-post
• redirected URL: /blog/new-blog-post
• redirect type: 301
• match type: exact

Place each value in its own column in your CSV so HubSpot can read it correctly.

Step-by-Step: Uploading Your CSV File to HubSpot

Once your CSV is ready, you can upload it directly into the URL redirects tool inside HubSpot.

1. Open the URL redirects tool in HubSpot

1. Sign in to your account.
2. Navigate to your Domains & URLs or Website settings, depending on your subscription and navigation layout.
3. Go to the URL Redirects section.

The exact menu label may vary slightly, but you will be looking for the URL management area inside HubSpot settings.

2. Start a bulk upload in HubSpot

1. Look for an option such as Bulk upload or Import redirects.
2. Click the button to begin the import process.
3. Choose your prepared CSV file from your computer.

HubSpot will verify the file structure and start reading your column headings.

3. Map CSV columns to HubSpot fields

Next, you must tell HubSpot which column represents which redirect property.

1. Confirm that the original URL column is mapped to the correct HubSpot field.
2. Confirm that the redirected URL column is mapped correctly.
3. Map any optional columns such as redirect type, match type, priority, or note.
4. Fix any unmapped or incorrectly mapped fields before proceeding.

Review the mapping carefully; this step determines how HubSpot creates each redirect rule.

4. Review and confirm your HubSpot bulk upload

1. Check the sample preview rows HubSpot displays from your file.
2. Look for obvious issues: missing paths, invalid URLs, or unsupported redirect types.
3. If everything looks correct, confirm and start the import.

When you confirm, HubSpot will process your CSV and create the redirect rules automatically.

How to Review and Test Redirects in HubSpot

After the import finishes, it is essential to verify that HubSpot created your redirects correctly and that they function as expected.

Check the imported redirects list

• Stay in the URL Redirects tool inside HubSpot.
• Filter or sort the list by creation date to see your most recent bulk upload.
• Confirm that the count of created redirects matches the number of successful rows in your CSV.

Test a sample of redirects manually

• Copy several original URLs from your CSV (or from the HubSpot redirect table).
• Paste each URL into a browser while logged out or using an incognito window.
• Confirm that your browser lands on the expected destination URL.
• Use a header checker tool to verify that the status code is the desired redirect type (for example, 301).

If you encounter errors, you can edit individual redirects directly inside HubSpot or correct your CSV and upload a new batch.

Best Practices for Managing Redirects in HubSpot

Well-organized redirects keep your site healthy and maintain strong organic traffic. When using HubSpot for redirects, follow these practical tips.

Plan your redirect strategy before uploading

• Audit existing URLs and group them by section or content type.
• Decide which pages should be redirected, consolidated, or removed.
• Create a clear naming and note convention in your CSV so teammates can understand each rule.

Avoid redirect chains inside HubSpot

• Do not redirect a URL to another URL that already redirects again.
• Whenever possible, redirect old URLs directly to the final live page.
• Periodically review your HubSpot redirect table and remove unnecessary intermediate steps.

Keep an organized log of your HubSpot uploads

• Store every CSV file you upload in a repository with dates and descriptions.
• Record who prepared each file and the purpose of the upload.
• Use the notes column in your HubSpot redirects to add context, such as “Q2 site migration” or “blog clean-up.”

Where to Learn More About HubSpot Redirects

For the most accurate, up-to-date details about supported columns, limits, and behavior, always reference the official HubSpot documentation:

• Official HubSpot bulk upload URL redirects instructions

If you need strategic help planning migrations or advanced redirect logic beyond the basics, you can consult experts who specialize in technical SEO and HubSpot implementations, such as Consultevo.

By following these steps and best practices, you can confidently manage large-scale URL changes inside HubSpot, protect your organic performance, and deliver a smooth experience to every visitor.

Need Help With Hubspot?

If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.

Scale Hubspot

“`