How do I set up a flexible pattern URL mapping?

Last updated: April 7, 2016

Available For:

Product: HubSpot Marketing
Subscription: Basic, Professional, & Enterprise

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 HubSpot's COS 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:
    • Navigate to Content > Content Settings.
    • From the lefthand sidebar, select COS URL Mappings.
    • 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:

Was this article helpful?