Skip to main content

Timeline Labels: Organizing Time Ranges on Your Timeline

Timeline Labels help you annotate meaningful time ranges in your timeline, for example vacations, business trips, events, or relocations.

What is a Timeline Label?​

A Timeline Label is a lightweight time-range annotation with:

  • Name: e.g. Vacation in Spain
  • Date range: start and end
  • Color: visual grouping across pages
  • Source: Manual, OwnTracks, or Trip

Use Timeline Labels when you want clear context on the timeline without adding planning details.

Where to manage labels​

Open Timeline Labels from the main menu (/app/timeline-labels).

On this page you can:

  • Create labels
  • Edit/delete labels
  • Filter by source and link state
  • Search by label name
  • Open timeline for a label range
  • Link a label to a Trip Plan

Create a label​

  1. Click Create Label.
  2. Enter a name.
  3. Select start/end dates.
  4. Pick or randomize a color.
  5. Save.

If the date range overlaps with existing labels, GeoPulse asks for confirmation before creating it.

Edit and delete​

  • Edit updates name/date/color.
  • Delete removes the label.
  • Bulk delete is available via table selection.

Linking labels with Trip Plans​

Timeline Labels and Trip Plans can be linked.

Main behavior:

  • Create Trip Plan from a label using Create trip plan action.
  • When linked, name, date range, and color are synchronized.
  • You can open linked Trip Plan directly from the label row.
  • You can unlink at any time.

Delete modes for linked labels:

  • Delete Label Only: removes the label, keeps the Trip Plan unlinked.
  • Delete Label + Trip Plan: removes both.

OwnTracks labels​

OwnTracks can create/update labels automatically.

  • Active OwnTracks labels are shown as active.
  • Active OwnTracks labels are read-only until completed.
  • After completion, labels can be edited/deleted like normal.

Timeline integration​

Use View timeline on a label row to open Timeline page pre-filtered to that range.

This is useful for:

  • Reviewing one trip/event window quickly
  • Comparing multiple named periods
  • Sharing a specific period with public links

Best practices​

  • Use descriptive names: Vacation: Spain 2026, Work Trip: NYC Client Visit.
  • Keep one label per distinct event window.
  • Use consistent colors for similar categories (vacation/work/event).