--- title: Comment - GraphQL Admin description: A comment on an article. api_version: unstable api_name: admin source_url: html: 'https://shopify.dev/docs/api/admin-graphql/unstable/objects/Comment' md: 'https://shopify.dev/docs/api/admin-graphql/unstable/objects/Comment.md' --- # Comment object Requires `read_content` access scope or `read_online_store_pages` access scope. A comment on an article. ## Fields * article [Article](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Article) The article associated with the comment. * author [Comment​Author!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CommentAuthor) non-null The comment’s author. * body [String!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String) non-null The content of the comment. * body​Html [HTML!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/HTML) non-null The content of the comment, complete with HTML formatting. * created​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/DateTime) non-null The date and time when the comment was created. * events [Event​Connection!](https://shopify.dev/docs/api/admin-graphql/unstable/connections/EventConnection) non-null The paginated list of events associated with the host subject. * id [ID!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/ID) non-null A globally-unique ID. * ip [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String) The IP address of the commenter. * is​Published [Boolean!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Boolean) non-null Whether or not the comment is published. * published​At [Date​Time](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/DateTime) The date and time when the comment was published. * status [Comment​Status!](https://shopify.dev/docs/api/admin-graphql/unstable/enums/CommentStatus) non-null The status of the comment. * updated​At [Date​Time](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/DateTime) The date and time when the comment was last updated. * user​Agent [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String) The user agent of the commenter. *** ## Map ### Fields and connections with this object * {}[Article.comments](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Article#field-Article.fields.comments) * <->[CommentConnection.nodes](https://shopify.dev/docs/api/admin-graphql/unstable/connections/CommentConnection#returns-nodes) * {}[CommentEdge.node](https://shopify.dev/docs/api/admin-graphql/unstable/objects/CommentEdge#field-CommentEdge.fields.node) *** ## Queries * [comment](https://shopify.dev/docs/api/admin-graphql/unstable/queries/comment) query Returns a `Comment` resource by ID. * [comments](https://shopify.dev/docs/api/admin-graphql/unstable/queries/comments) query List of the shop's comments. *** ## \Comment Queries ### Queried by * \[comment](https://shopify.dev/docs/api/admin-graphql/unstable/queries/comment) * \[comments](https://shopify.dev/docs/api/admin-graphql/unstable/queries/comments) *** ## Mutations * [comment​Approve](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/commentApprove) mutation Approves a comment. * [comment​Not​Spam](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/commentNotSpam) mutation Marks a comment as not spam. * [comment​Spam](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/commentSpam) mutation Marks a comment as spam. *** ## <\~> Comment Mutations ### Mutated by * <\~>[comment​Approve](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/commentApprove) * <\~>[comment​Not​Spam](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/commentNotSpam) * <\~>[comment​Spam](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/commentSpam) *** ## Interfaces * * [Has​Events](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasEvents) interface * [Node](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Node) interface *** ## ||-Comment Implements ### Implements * ||-[Has​Events](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/HasEvents) * ||-[Node](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Node)