> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful.com/developers/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/_mcp/server.

[Timeline](https://www.contentful.com/help/timeline/) is a feature by Contentful that allows you to create, schedule and preview multiple upcoming versions of the same digital experience.

> **Info**
>
> **Note:** The Timeline feature is available on specific plans. For more information, [reach out](https://www.contentful.com/contact/sales/) to your Sales representative.

To use the Timeline Preview feature, you can:

1. Install the official [contentful.js](https://github.com/contentful/contentful.js) JavaScript library. Make sure you are on version **v11.9.0** or higher.

Assuming the website logic is already [updated to read the URL query parameters](https://www.contentful.com/help/timeline/#richtxt-required-code-changes/), all you need to do is pass those values when initializing the Contentful client, for example:

```js
import * as contentful from 'contentful'
import { parseTimelinePreviewToken } from '@contentful/timeline-preview'

// "timeline" value should be taken from the URL query param value configured in the "Create a preview platform" section above
const { releaseId, timestamp } = parseTimelinePreviewToken(timeline)

const client = contentful.createClient({
  space: 'yadj1kx9rmg0',
  host: 'preview.contentful.com',
  // Provide either release or timestamp (or both maybe be passed if the release is scheduled) as a valid config
  timelinePreview: {
    release: { lte: releaseId },
    timestamp: { lte: timestamp },
  },
 // ... any other options as normal
})
```

The output client **must** be used in all subsequent requests to ensure a consistent preview experience.

2. If you're not using the official JavaScript client, you'll need to configure your requests manually. When timeline preview is enabled, make sure all preview entry and asset requests are directed to the `/timeline/` endpoints, and include the appropriate `release` and/or `timestamp` query parameters. See below for details.

## Query entries using release ID

Retrieves entries across the timeline, similar to the [Entries Collection](/references/content-preview-api/entries/get-all-entries) endpoint. Entries are resolved across the timeline starting from the specified release, falling back to the previous scheduled release or the currently published version.

[Get all entries](/references/content-preview-api/timeline/get-all-timeline-entries)

## Query entries using timestamp

Retrieves entries across the timeline, similar to the [Entries Collection](/references/content-preview-api/entries/get-all-entries) endpoint. Entries are resolved across the timeline starting from the specified timestamp, falling back to the previous scheduled release or the currently published version.

[Get all entries](/references/content-preview-api/timeline/get-all-timeline-entries)

## Fetch an entry using release ID

The equivalent of [Entry](/references/content-preview-api/entries/get-an-entry) endpoint for resolving content across the timeline.

[Get an entry](/references/content-preview-api/timeline/get-a-timeline-entry)

## Fetch an entry using timestamp

The equivalent of [Entry](/references/content-preview-api/entries/get-an-entry) endpoint for resolving content across the timeline.

[Get an entry](/references/content-preview-api/timeline/get-a-timeline-entry)

## Query assets using release ID

Retrieves assets across the timeline, similar to the [Assets Collection](/references/content-preview-api/assets/get-all-assets) endpoint. Assets are resolved across the timeline starting from the specified release, falling back to the previous scheduled release or the currently published version.

[Get all assets](/references/content-preview-api/timeline/get-all-timeline-assets)

## Query assets using timestamp

Retrieves assets across the timeline, similar to the [Assets Collection](/references/content-preview-api/assets/get-all-assets) endpoint. Assets are resolved across the timeline starting from the specified timestamp, falling back to the previous scheduled release or the currently published version.

[Get all assets](/references/content-preview-api/timeline/get-all-timeline-assets)

## Fetch an asset using release ID

The equivalent of [Asset](/references/content-preview-api/assets/get-an-asset) endpoint for resolving content across the timeline.

[Get an asset](/references/content-preview-api/timeline/get-a-timeline-asset)

## Fetch an asset using timestamp

The equivalent of [Asset](/references/content-preview-api/assets/get-an-asset) endpoint for resolving content across the timeline.

[Get an asset](/references/content-preview-api/timeline/get-a-timeline-asset)


## API Docs

- Timeline [Get all timeline entries](https://contentful.com/developers/docs/references/content-preview-api/timeline/get-all-timeline-entries.md)
- Timeline [Get a timeline entry](https://contentful.com/developers/docs/references/content-preview-api/timeline/get-a-timeline-entry.md)
- Timeline [Get all timeline assets](https://contentful.com/developers/docs/references/content-preview-api/timeline/get-all-timeline-assets.md)
- Timeline [Get a timeline asset](https://contentful.com/developers/docs/references/content-preview-api/timeline/get-a-timeline-asset.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://contentful.com/developers/docs/openapi.json)
- [OpenAPI YAML](https://contentful.com/developers/docs/openapi.yaml)