---
title: analyticsAnnotationDelete - GraphQL Admin
description: >-
  Deletes an [analytics
  annotation](https://shopify.dev/docs/api/admin-graphql/latest/objects/AnalyticsAnnotation).

  An app can delete only annotations that it created. If an app attempts to
  delete an annotation that it

  didn't create, then the mutation returns a `NOT_FOUND` error.

  Use
  [`analyticsAnnotationCreate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/analyticsAnnotationCreate)

  to create a new annotation, or

  [`analyticsAnnotationUpdate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/analyticsAnnotationUpdate)

  to modify existing ones.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/mutations/analyticsAnnotationDelete
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/mutations/analyticsAnnotationDelete.md
api_name: admin
api_type: graphql
type: mutation
---

# analytics​Annotation​Delete

mutation

Requires Requires `write_analytics_annotations` access scope.

Deletes an [analytics annotation](https://shopify.dev/docs/api/admin-graphql/latest/objects/AnalyticsAnnotation). An app can delete only annotations that it created. If an app attempts to delete an annotation that it didn't create, then the mutation returns a `NOT_FOUND` error. Use [`analyticsAnnotationCreate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/analyticsAnnotationCreate) to create a new annotation, or [`analyticsAnnotationUpdate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/analyticsAnnotationUpdate) to modify existing ones.

## Arguments

* id

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

  required

  The ID of the analytics annotation to delete.

***

## Analytics​Annotation​Delete​Payload returns

* deleted​Id

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

  The ID of the deleted analytics annotation.

* user​Errors

  [\[Analytics​Annotation​Delete​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/AnalyticsAnnotationDeleteUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### analyticsAnnotationDelete reference