---
title: "Pebble Timeline"
canonical_url: https://developer.repebble.com/guides/pebble-timeline/
last_updated: 2026-10-11
sdk_version: 4.33.1
---
# Pebble Timeline

Source: https://developer.repebble.com/guides/pebble-timeline/

The Pebble timeline is a system-level display of chronological events that apps can insert data into to deliver user-specific data, events, notifications and reminders. These items are called pins and are accessible outside the running app, but are deeply associated with an app the user has installed on their watch.

Every user can view their personal list of pins from the main watchface by pressing Up for the past and Down for the future. The Pebble mobile app inserts pins for weather, calendar events and missed calls, and apps insert their own pins, such as sports scores or news items, from PebbleKit JS.

## Contents

- [**Creating Pins**](https://developer.repebble.com/guides/pebble-timeline/pin-structure.md) - How to create timeline pins with reminders, actions, and layouts.

- [**Local Pins**](https://developer.repebble.com/guides/pebble-timeline/timeline-local-pins.md) - How to insert pins into the timeline directly from PebbleKit JS, without a web server or timeline API keys.

- [**Subscriptions and Tokens**](https://developer.repebble.com/guides/pebble-timeline/timeline-js.md) - The PebbleKit JS timeline subscription and token APIs, and what to use instead.

## Adding Pins

Apps add pins from PebbleKit JS with `Pebble.insertTimelinePin()` and remove them with `Pebble.deleteTimelinePin()`. The Pebble mobile app creates the pin and syncs it to the watch. No timeline token, API key or appstore listing is needed, so sideloaded apps can add pins. See [_Local Pins_](https://developer.repebble.com/guides/pebble-timeline/timeline-local-pins.md) for the API and [_Creating Pins_](https://developer.repebble.com/guides/pebble-timeline/pin-structure.md) for the pin format.

> Note: The timeline web API is no longer available. The Pebble mobile app does not sync pins from a server, and `Pebble.timelineSubscribe()`, `Pebble.timelineUnsubscribe()` and `Pebble.timelineSubscriptions()` do not work. Use [_local pins_](https://developer.repebble.com/guides/pebble-timeline/timeline-local-pins.md) instead.