Articles on: Artworks

This article is also available in:

GPX Route feature

The customers can now upload their running or cycling routes using a GPX file. Once uploaded, their path will be automatically highlighted on the preview!
The feature also supports pulling data from the route — such as total distance, starting and ending points, and start/end dates — so you can display these info automatically in the design.

Continue reading this Article to learn more about setting up this feature on your Store.

Creating the Artwork with Route Map Layer

In order for this feature to work, please be sure you have successfully connected to Mapbox service first.

In the Artwork editor, click + Layer, then select Maps & Astronomy > Route Maps.

Click the edit icon on the new layer to open its settings.

Design Settings

The following list explains what each of these settings does:

Upload GPX default: You can upload a default GPX route that will appear on the Live Preview by default—perfect for showing customers what their personalized product could look like before they upload their own route.
Default zoom level: Set the default zoom level for the map route display. Keep in mind—zooming in too much might cut off parts of the route, especially longer ones. Aim for a balance that shows the full path clearly.
Default line color: Choose the default color for the highlighted route on the map.
Default line thickness: Set how thick the route appears on the map. A thicker line stands out more, while a thinner one gives a more subtle look. Choose what fits your design best.
Default Map styles URL: Select the visual style of the map by entering a Map Style URL. This controls the overall look—like colors, labels, and terrain—so you can match it to your product’s vibe. Please refer to the following article for more details.
Show Marker/Pin: Enable this option to display markers for the start and finish points of the route. You can upload your own custom icons for the start point and the last point, and specify both their width and height to ensure they fit your design accurately.

Personalization Settings

Option Title: The option title for the Route Map layer, shown on the personalization form.
Allow customers to change elevation profile: Show the elevation profile of the route on the map, and let customers choose its size. You can set the default elevation profile color and size (Small, Medium or Large), the label of the option, and how the options are displayed on the personalization form.
Add instruction for customer: Add a short instruction shown to customers under this option.

Creating Layers for Distance, Start Point, End Point, Start Date, End Date

Make your design even more meaningful by adding details like distance, start and end points, and start/end dates. These elements automatically pull data from the uploaded Map Route, so once the customer uploads their GPX file, the info shows up instantly—no extra work required.

Before we begin, please read about our Auto-populate values from other options feature

Populating values from the Map Route layer

Adding Distance info to the Design

First, please create a static layer and name it Distance: similar to the screenshot. This layer serves purely as a title or label—it won’t display any actual route data just yet.
Then, create a new text layer where the actual distance will appear. This layer will automatically pull the distance data from the uploaded Map Route, so it updates based on each customer’s GPX file.

👉 In case you need a reminder, when editing a Text layer, open the Populate Values section and enable the toggle Populate Content from another option. Then, under Source option, select the Layer you want to populate value from, which is the GPX Map Route layer.

Once you've selected the GPX Map Route layer, enter the value to populate in the Value field -- in this case, it is the distance. You can click + Available Value to see and pick from all available values.

Please be sure to enter the suffix after the value as well! In this case, we are using kilometer as a measurement. So the Value is {{route_distance}} km . This way, the final output will look something like “12.4 km” instead of just a number.

Want to use another unit? Use {{route_distance:m}} for meters or {{route_distance:mi}} for miles, and change your suffix to match.

Adding Start Point, End Point to the Design

Just like with the Distance info, begin by adding static text layers labeled Start Point and End Point. These serve as titles in your design to keep things clear and organized.

To create the populate layer, be sure to select the Route Map layer as its Source option, and set its Value accordingly:

👉 Keep in mind:
When working with latitude and longitude values, you can use other formatting options available in the Map Street Map section. Just make sure you enter the correct prefix — route_start_point (or route_end_point if you're showing the end).

For example, instead of using:
route_start_point.lat, route_start_point.lng
You can use the formatted version:
route_start_point.lat:dd, route_start_point.lng:dd
to display them in decimal degrees.

Adding the Elevation gain/loss to the Design

The Elevation returns the total elevation gain and elevation loss along the route. This means it calculates how much the path goes uphill and downhill overall, based on the GPX data. It’s useful for showing the difficulty or terrain profile of a route

Just like before, add a static layer for Elevation Gain and another layer for its value.
Repeat the same for Elevation Loss if needed.

In the elevation value field for gain/loss, make sure to add “+” or “–” as a prefix.

The Elevation Gain/Loss value is returned in meters, so be sure to add the appropriate unit—such as m, meter, or meters—as a suffix in your text layer to display it clearly.

To enhance the GPX map and display the elevation profile, turn on “Allow customers to change elevation profile” in the Personalization Settings of the GPX Map Route layer.

Adding final touches to the Design

To make your design more polished and personal, consider adding customizable layers like the Marathon Name, Runner's Name, Bib Number, or any other details that make the product feel special.

Detailed explanation regarding the value table

The Value Table lets you define what data should appear in each dynamic text layer. It connects your text layer to a specific data source (like the Map Route), and lets you choose exactly which value to display—such as distance, start point, or end date

Format	Meaning	Example
{{route_distance}}	Returns total route distance in kilometers	66.5 km
{{route_distance:m}}	Returns total route distance in meters
{{route_distance:mi}}	Returns total route distance in miles
{{route_start_point.lat}}, {{route_start_point.lng}}	Returns starting point (can use other formats as in Street maps).	21.0285°N, 105.8544°E
{{route_end_point.lat}}, {{route_end_point.lng}}	Returns ending point (can use other formats as in Street maps).	21.0772°N, 105.9401°E
{{route_start_date}}	Returns start date of the route. For cleaner and more flexible formatting, we recommend using the Date Picker feature instead of pulling raw date values. It offers a variety of date formats and displays the information in a more polished, user-friendly way—perfect for making your design look its best.	2025-05-27T00:00
{{route_end_date}}	Returns end date of the route. For cleaner and more flexible formatting, we recommend using the Date Picker feature instead of pulling raw date values. It offers a variety of date formats and displays the information in a more polished, user-friendly way—perfect for making your design look its best.	2025-05-27T00:00
{{elevation_gain}}	Returns the total elevation gain along the route, in meters. It’s useful for showing the difficulty or terrain profile of a route
{{elevation_loss}}	Returns the total elevation loss along the route, in meters. It’s useful for showing the difficulty or terrain profile of a route
{{route_duration}}	Returns duration of the route in h:m:s form (eg. 20:30:40).
{{route_duration:h.m.s}}	Returns duration of the route in h.m.s form (eg. 20.30.40).
{{route_duration:unit:h}}	Returns duration of the route in unit h form (eg. 20h30'40'').
{{route_duration:unit:hms}}	Returns duration of the route in unit hms form (eg. 20h30m40s).

Importing Routes from Strava

Customers can now connect their Strava account directly to the store. Once connected, they can browse and select from their past activities—like runs or rides—and instantly import the route data. It's a faster, easier way to personalize their product without needing to upload a GPX file manually!

At the moment, this feature is enabled by default.

On the Storefront, the Customer will see the Connect Strava button next to Choose a .gpx file:

Once clicked, they will be prompted to connect their Account with Teeinblue

Once connected, customers can easily search for and select their preferred route from their Strava activity list

Creating the Campaign

Once you're done with creating the Artwork, add it to your Campaign as usual!

Be sure to double-check it on your Storefront to make sure all's good!

Updated on: 18/10/2026

Was this article helpful?

Thank you!