The Dictionary

Help guide · Updated June 25, 2026

What this is. The Dictionary is where you define the kinds of things you draw on the map. A "type" is a name (Campsite, Trail, Water source), an icon, a color, and an optional set of custom fields. Once a type exists, drawing a feature of that type takes one tap — and the form you fill in is the one you designed. Out of the box you get a sensible starter set; from there it's yours to shape.

Open the Dictionary

The Dictionary lives in the More menu — the three-dot icon at the right end of the toolbar.

The More menu opened, showing Tools, Activity, Explore 3D, Dictionary, Offline data, and other items.
Tap More, then Dictionary. (You can also see the Map tools toggle at the top of this menu — that's where the types you define here actually get used.)

Three dictionaries, one for each geometry

The dialog has three tabs across the top — one per shape you can draw on the map.

Dictionary dialog open on the Point tab, showing existing types (Campsite, Point of interest, Water, Restroom) and a New Type form with name, icon picker, and color picker.
Point tab: types for individual pins. Each row is one type, with its icon and color preview.
Line tab showing Trail, Road, Road Ride, and MTB Ride types, each with a distinctive icon and color.
Line tab — your inventory of trail and route flavors. Each type carries its own color; whichever one you pick, the trail or route you draw or record will appear in that color on the map.

The anatomy of a type

Tap an existing type in any list to expand its editor. Every type has the same four parts.

Edit Type form for Campsite showing name field, icon picker grid, color picker row, and a collapsed Attributes (0) section.
Editing the built-in Campsite type. Same form as New type, pre-filled.

Tap Save to commit your changes, or Cancel to bail. The red trash icon next to a type in the list deletes the type itself — existing features keep their data but lose the type definition.

Designing your own fields

The Attributes section is the real power of the Dictionary. Tap Attributes to expand it.

Attributes section expanded, showing 'No fields. Features of this type get the free-form name+comment form.' and an Add field button.
Empty state. The default form is just name + comment — fine for many things, but you can do better.

Tap + Add field to add a custom field.

Single attribute field configuration showing key, label, type dropdown set to Text, Required checkbox, reorder arrows, delete icon, and a hint/placeholder field.
One field. Repeat + Add field for each thing you want to capture.

Each field has these knobs:

FieldWhat it does
keyThe internal name (e.g. waterType). Stored with the feature and used when you export. Use camelCase and no spaces.
LabelThe human-readable name shown in the form (e.g. Water type). Edit freely.
TypeHow the input renders — Text, Number, Boolean (a checkbox), or Select (dropdown).
RequiredIf checked, the user can't save the feature without filling this in.
Hint / placeholderOptional gray helper text inside the input — handy for examples or units ("e.g. spring-fed", "GPM").
↑↓ reorderChange the order fields appear in on the form.
TrashDelete the field from this type. Doesn't affect existing features.

For Select fields a "Options, comma-separated" input appears so you can list the allowed values.

Design the form for the field, not the database. Field labels are what you see while you're standing in a downpour trying to log a thing. Make them obvious — "Source type" beats src_t, even though src_t is what gets saved.

Creating a brand-new type

Below the list on any tab is the New type form — same fields as Edit, but blank.

  1. Give it a name.
  2. Pick an icon. The first row tends to be the most recognizable.
  3. Pick a color distinct from anything you already have, so it stands out on the map.
  4. (Optional) Expand Attributes and add your custom fields.
  5. Tap + Add to commit. The new type appears in the list and is immediately available in the drawing tools.

What about the Polygon tab?

Polygons work the same way — name, icon, color, attributes — but the starter list is smaller because the use cases are narrower.

Polygon tab with one type: Camp area, using a green tent icon.
Out of the box there's just Camp area. Add your own as needs come up — burn scars, group sites, areas to avoid.

Tips

Edits sync to your account. When you're signed in, your dictionary syncs to your other devices and to the Apple Watch (the watch uses your icon + color to render features). On the watch, your dictionary is what makes one-tap capture possible.
Required fields can be a trap. Marking too many fields Required slows down capture in the field. Reserve it for the one or two things you'll always regret not having later (date, severity) and leave the rest optional.
Deleting a type is safe-ish. The features you've already drawn keep their saved data — they just lose their type. The icon falls back to a generic pin and the custom fields turn into a flat key/value list. So if you want to clean up an unused type, you can.