Set up a flexible pattern URL mapping

Last updated: February 8, 2019

Flexible pattern URL mappings allow you to dynamically redirect urls that have a certain url structure, maintaining parts of the original URL in the destination URL. In the URL mappings tool, you can define components of the URL that you would like to add to the destination URL.

To create a flexible pattern mapping:
  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, navigate to Domains & URLs.
  • Click the URL Mappings tab.
  • Click Add URL redirect > Add one redirect.
  • Click Show advanced options.
  • Select the Advanced: Original URL is a flexible pattern URL checkbox.
  • Define your Original URL or Path and Your Destination URL or Path using the syntax below.
User-added image

To define a component part of a URL, use a colon : followed by a name for that variable in the origin URL. To add that component to your destination URL add the same name wrapped in {}. Each piece of the URL path between / / must have its own component, if you would like to include it as a variable in the destination URL.

The one exception to this rule is that you can add the entire end of a URL (up until the query string) as a single component using the * symbol followed by a name for the rest of the URL. Any non-component text in the destination URL will not be dynamically replaced. Below are several examples of flexible pattern URL mappings.


Keeping individual components from original URL

If your original URL structure contained a common pattern such as a date that you wanted to include in the destination URL, you could use a flexible pattern mapping.

Example URL:

Original URL:

Destination URL:{month}/{day}/{year}/{post-name}

After saving this mapping, original example URL would redirect to:


Defining the end of the URL as a component

Sometimes you may want to make the entire end (up until a query string) of a URL one component.

Example URL:

Original URL path :*rest-of-url

Destination URL:{rest-of-url}

After saving this mapping, original example URL would redirect to:


Using both individual components and the rest of the URL

Example URL:

Original URL path :*rest-of-url?post-id=:post-id

Destination URL:{month}-{day}-{year}/post-{post-id}/{rest-of-url}.

After saving this mapping, original example URL would redirect to: