Choose a version:

commentDelete

mutation

Requires Any of write_content, write_online_store_pages access scopes.

Permanently removes a comment from a blog article.

For example, when a comment contains spam links or inappropriate language that violates store policies, merchants can delete it entirely.

Use the commentDelete mutation to:

Remove spam or inappropriate comments permanently
Clean up irrelevant discussions
Maintain content standards on blog articles

Deletion is permanent and can't be undone.

Anchor to Arguments

Arguments

Anchor to idid •ID! required: The ID of the comment to be deleted.

Was this section helpful?

Anchor to CommentDeletePayload returnsCommentDeletePayload returns

Anchor to deletedCommentIddeletedCommentId •ID: The ID of the comment that was deleted.
Anchor to userErrorsuserErrors •[CommentDeleteUserError!]! non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Examples

Removes a comment

Query

mutation CommentDelete($id: ID!) {
  commentDelete(id: $id) {
    deletedCommentId
    userErrors {
      code
      field
      message
    }
  }
}

Variables

{
  "id": "gid://shopify/Comment/757536350"
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation CommentDelete($id: ID!) { commentDelete(id: $id) { deletedCommentId userErrors { code field message } } }",
 "variables": {
    "id": "gid://shopify/Comment/757536350"
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation CommentDelete($id: ID!) {
    commentDelete(id: $id) {
      deletedCommentId
      userErrors {
        code
        field
        message
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/Comment/757536350"
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation CommentDelete($id: ID!) {
    commentDelete(id: $id) {
      deletedCommentId
      userErrors {
        code
        field
        message
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/Comment/757536350"
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation CommentDelete($id: ID!) {
      commentDelete(id: $id) {
        deletedCommentId
        userErrors {
          code
          field
          message
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/Comment/757536350"
    },
  },
});

Response

{
  "commentDelete": {
    "deletedCommentId": "gid://shopify/Comment/757536350",
    "userErrors": []
  }
}

commentDelete reference

Examples

Open in GraphiQL

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

mutation CommentDelete($id: ID!) {

commentDelete(id: $id) {

deletedCommentId

userErrors {

code

field

message

}

}`,

{

variables: {

"id": "gid://shopify/Comment/757536350"

);

const json = await response.json();

return json.data;

}

GQL

mutation CommentDelete($id: ID!) {
  commentDelete(id: $id) {
    deletedCommentId
    userErrors {
      code
      field
      message
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation CommentDelete($id: ID!) { commentDelete(id: $id) { deletedCommentId userErrors { code field message } } }",
 "variables": {
    "id": "gid://shopify/Comment/757536350"
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation CommentDelete($id: ID!) {
    commentDelete(id: $id) {
      deletedCommentId
      userErrors {
        code
        field
        message
      }
    }
  }`,
  {
    variables: {
        "id": "gid://shopify/Comment/757536350"
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation CommentDelete($id: ID!) {
      commentDelete(id: $id) {
        deletedCommentId
        userErrors {
          code
          field
          message
        }
      }
    }`,
    "variables": {
        "id": "gid://shopify/Comment/757536350"
    },
  },
});

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation CommentDelete($id: ID!) {
    commentDelete(id: $id) {
      deletedCommentId
      userErrors {
        code
        field
        message
      }
    }
  }
QUERY

variables = {
  "id": "gid://shopify/Comment/757536350"
}

response = client.query(query: query, variables: variables)

Input variables

JSON

{

"id": "gid://shopify/Comment/757536350"

}

Response

JSON

{

"commentDelete": {

"deletedCommentId": "gid://shopify/Comment/757536350",

"userErrors": []

}