> 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/developers/docs/_mcp/server.

# Timeline

[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 enable Timeline Preview, you need to use the `@timeline` directive and pass the Timeline preview tokens as arguments. For example:

```graphql
query @timeline(where: { release_lte: "<releaseId>", timestamp_lte: "<date>" }) {
  blogCollection(preview: true) {
    items {
      sys {
        id
      }
      title
    }
  }
}
```

Notes:

* The `@timeline` directive is a query-level directive.
* You need to ensure that the directive is present in all preview queries made by your website.
* The `preview` argument must be set to `true`, just like regular preview. If the `preview` argument is set to `false`, the directive has no effect.
* The `@timeline` directive should work with all of your existing GraphQL queries. If something doesn't work, please report a bug.