# 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).

## Related pages

- [Timeline Overview](/docs/user-guide/core-features/timeline)
- [Trip Plans Management](/docs/user-guide/core-features/trip-plans)
- [Trip Workspace](/docs/user-guide/core-features/trip-workspace)
- [OwnTracks Source](/docs/user-guide/gps-sources/owntracks)