# Comments

Comment refers to a user-generated response or reaction to a specific piece of content, such as a post or content. Comments enable users to engage in conversations and express their thoughts, opinions, and emotions about the content they see. They provide a way for users to interact with each other and create a sense of community around the content. Commenting is an essential feature for social platforms as it encourages user engagement, helps create a more immersive experience for users, and can be used to generate insights into user behavior and preferences. In a social.plus SDK product, the SDK provides the necessary tools and functionality for developers to integrate commenting into their apps or websites.

Furthermore, a comment supports real-time events and Live Object features, for more information please refer to [Live Objects/Collections](/social-plus-sdk/core-concepts/live-objects-collections.md) and [Realtime Events](/social-plus-sdk/core-concepts/realtime-events.md).

### Comment Reference Type <a href="#create-comment" id="create-comment"></a>

Incorporating comment reference types within your app enhances user engagement and promotes interaction, as it allows users to comment on both regular posts and content-specific posts. By differentiating between these two comment types, your app can provide a more organized and contextual commenting experience, catering to the diverse needs of your users and the content they interact with. Comment's `referenceType` can be:

1. **Post type comment:** A post type comment is designed for regular posts, such as text updates, photos, or videos shared by users. These comments are associated with the regular post and are displayed beneath it, facilitating conversation and interaction.
2. **Story type comment:** Similar to post-type comments, these comments are associated with each story, driving user conversation.
3. **Content type comment:** A content type comment, on the other hand, is intended for content-specific posts, such as articles, or other specialized content.

### Comment Repository

The functionality of comments can be utilized through the Comment Repository, which offers methods for interacting with a data source that stores posts. This includes methods for querying comments, creating a new comment, updating an existing comment, or deleting a comment.

{% tabs %}
{% tab title="iOS" %}
{% embed url="<https://gist.github.com/amythee/cac39f58dca4faf3d7f9a52311017cd5#file-create_comment_repository-swift>" %}
Initialize comment repository
{% endembed %}
{% endtab %}

{% tab title="Android" %}
{% embed url="<https://gist.github.com/amythee/4505a8a70c8d92ebc112e156d979acf7#file-amitycommentrepositoryinitialization-kt>" %}
{% endtab %}

{% tab title="JavaScript" %}

```javascript
import { CommentRepository } from '@amityco/js-sdk';
```

{% endtab %}

{% tab title="TypeScript" %}
The functionality isn't currently supported by this SDK.
{% endtab %}

{% tab title="Flutter" %}
{% embed url="<https://gist.github.com/amythee/0175953fbd804e31dde252f26c3d8819#file-amitycommentrepoinitialization-dart>" %}
{% endtab %}
{% endtabs %}

### Comment Description

| Name               | Data Type       | Description                                                     |
| ------------------ | --------------- | --------------------------------------------------------------- |
| `commentId`        | `String`        | ID of the comment                                               |
| `userId`           | `String`        | ID of the user who posted the comment                           |
| `parentID`         | `String`        | ID of a parent comment                                          |
| `refrenceId`       | `String`        | ID of a reference                                               |
| `referenceType`    | `String`        | Type of a reference                                             |
| `dataType`         | `String`        | Type of the comment                                             |
| `data`             | `Object`        | Body of the comment                                             |
| `metadata`         | `Object`        | Additional properties to support custom fields                  |
| `childrenNumber`   | `Number`        | Number of children comments                                     |
| `flagCount`        | `Integer`       | Number of users who has read the comment                        |
| `reactions`        | `Object`        | Mapping of reaction with reactionCounter                        |
| `reactionsCount`   | `Integer`       | Number of all reactions for the comment                         |
| `myReactions`      | `Array<String>` | List of my reactions to the comment                             |
| `isDeleted`        | `Boolean`       | Flag that determines if comment is deleted                      |
| `editedAt`         | `DateTime`      | Date/time when comment was edited                               |
| `createdAt`        | `DateTime`      | Date/time when comment was created                              |
| `updatedAt`        | `DateTime`      | Date/time when comment was updated or deleted                   |
| `childrenComments` | `String`        | Children comments                                               |
| `hashflag`         | `Object`        | Flag for checking internally if this comment is reported or not |
| `mentionees`       | `Array<String>` | User IDs of the mentioned users                                 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.social.plus/social-plus-sdk/social/comments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.