Tags ​
Komodo lets you add arbitrary tags to routes to help you organize and filter them. Tags are shown as pills under the title of each route.
When viewing routes, you can choose to either include, exclude, or ignore them based on their tags.
Adding tags to routes ​
Tags can be added to a route by including a specially formatted label in the route name using the Komoot website or app as usual. There is currently no visual editor for tags.
For example, setting a route name to [status:WIP] My Route [Start Point:Home] [direction:north] will add the following tags to the route:
My Route
direction: northStart Point: Homestatus: WIP
Tag formats ​
Tags can be written in several ways. Here are some examples:
| Example | Explanation | Input | Preview |
|---|---|---|---|
| Single tag | A tag is made up of a name, separator, and value, surrounded by square brackets. | [direction:North] | direction: North |
| Multiple tags | You can include multiple tags in a route, and they can be anywhere in the route name. | [dir:N] [type:loop] | dir: Ntype: loop |
| Multiple tags w/ the same name | You can even have multiple tags with the same name. | [if:sunny] [if:rainy] | if: sunnyif: rainy |
| Multiple inline values | To save space, you can add multiple values in a single tag, separated by commas. They will still be displayed as separate tags. | [members:Jerry,Liu] | members: Jerrymembers: Liu |
| Nameless tags | Tags don't need to have a name. This is useful for tags that are either true or false. | [downhill] [low traffic] | downhilllow traffic |
| Multiple inline nameless tags | You can have multiple values in a nameless tag. | [downhill, low traffic] | downhilllow traffic |
TIP
Note that tags will be stripped from the route name when displayed, so if you add them between words, the resulting title may have weird spacing.
If you want cleaner route names on mobile, consider adding them at the end.
Allowed characters ​
Tags can contain almost any value:
| Example | Explanation | Input | Preview |
|---|---|---|---|
| Capital letters | Tags are case-sensitive. | [a:b] [A:B] | a: bA: B |
| Whitespace | You can include whitespace around names and values—it will be stripped out when the tag is displayed. | [a:b], [a: b], or [ a : b ] | a: b |
| Multi-word names/values | Spaces in the middle of tag names and values will be preserved, so you can have multi-word names and values. | [Start Point:Home] | Start Point: Home |
| Numbers | Numbers are allowed. | [priority:6] [420:yes] | priority: 6420: yes |
| Emojis | Emojis are allowed. | [đź“Ť:ATL] [by:đźš—] | đź“Ť: ATLby: đźš— |
| Special characters | Most special characters are allowed. See below for details. | [difficulty:!@#$%] | difficulty:!@#$% |
TIP
Although you can use emojis, it might be better to use easy to type names/values and replace them with emojis for display purposes using CSS. This is described in more detail in the advanced usage section.
If you use Komoot on mobile, it might be a good idea to name tags such that you can filter them using the built-in search function.
Disallowed characters ​
The special characters [, ], and :, and , are not allowed in tag names and values because they are used to delimit tags. Using one of these values may result in undefined behavior. Emojis, spaces, and all other characters are allowed.
TIP
The delimiters used by the script are defined in src/constants.ts. If you need to use different characters, you can change them and build the script yourself.
Loading all routes ​
This script uses the tags found in the route list to populate the filter controls.
By default, Komoot only loads a handful of routes at a time, so if you notice that some tag names/values are missing from the filter controls, click the Load All Routes button to force load the entire list of routes. This may take a few seconds to complete.
Filtering by tags ​
On the route list page, you can filter routes by tag. A group of checkboxes will be added to the Filter by section for each tag name.
By default, nothing will be filtered out of the list. Click a checkbox once to only show routes with that value. Click the checkbox a second time to exclude any routes with that value. You can click once more to reset the checkbox.
 |  |  |
|---|---|---|
| An unselected checkbox | An include checkbox | An exclude checkbox |
You can filter by multiple tag names/values at the same time. By include/exclude checking all checkboxes in a tag name group, you can effectively filter routes by the presence of that tag name. For example, exclude checking all checkboxes for the status tag name will show you routes that you haven't assigned a status.
TIP
It is also possible to search through tags using the search box, because the built-in Komoot search feature still uses the original route titles.
This means keyword order is important while searching, and because keywords you enter may unexpectedly match tags, you may want to name them accordingly to avoid this.
For example, you could search for [status: to get all routes with tag name status.