---
title: AnalyticsAnnotationCreateInput - GraphQL Admin
description: >-
  The input fields for creating an [analytics
  annotation](https://shopify.dev/docs/api/admin-graphql/latest/objects/AnalyticsAnnotation).
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/AnalyticsAnnotationCreateInput
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/input-objects/AnalyticsAnnotationCreateInput.md
api_name: admin
api_type: graphql
type: input-object
---

# Analytics​Annotation​Create​Input

input\_object

The input fields for creating an [analytics annotation](https://shopify.dev/docs/api/admin-graphql/latest/objects/AnalyticsAnnotation).

## Fields

* description

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  A plain-text description that provides additional context. The maximum length is 150 characters.

* ended​At

  [Date​Time](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  The date and time when the annotation ended. Omit for point-in-time annotations. Set to `null` for open-ended annotations.

* started​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime)

  non-null

  The date and time when the annotation started.

* title

  [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  non-null

  The title of the annotation, displayed on the chart marker. The maximum length is 75 characters.

* type

  [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  non-null

  A supported type for an app-created annotation. Refer to the list of [supported types](https://shopify.dev/docs/api/shopifyql/latest/syntax/annotate#annotation-categories-and-types).

***

## Mutations using this input

* [analytics​Annotation​Create.input](https://shopify.dev/docs/api/admin-graphql/latest/mutations/analyticsAnnotationCreate#arguments-input)

  ARGUMENT

***

## Map

### Mutations using this input

* [analytics​Annotation​Create.input](https://shopify.dev/docs/api/admin-graphql/latest/mutations/analyticsAnnotationCreate#arguments-input)