How do I set up a flexible pattern URL mapping?

Last updated: December 12, 2018

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.
  • From the lefthand sidebar, click Domains & URLs, then click the URL Mappings tab.
  • Click Add a new redirect > Add one redirect.
  • Click on Show advanced options.
  • Check Advanced: Original URL is a flexible pattern URL.
  • 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:

Free Inbound Marketing Training Learn inbound marketing techniques that range from creating content, using  social promotion, converting and nurturing leads, and all the way to marketing  to your customers. Start the course