FeedComment

Represents a comment added to a feed by a user. This object is available in API version 18.0 and later.

Supported Calls

create(), delete(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), update(), upsert()

Special Access Rules

Note the following when working with feed comments.

You must have read access to the feed’s parent type to see a FeedComment record.
You must have access to the feed to add a comment.
If the comment is related to a user record, the user can delete the comment. For example, if John Smith makes a comment on Sasha Jones’ profile feed, Sasha can delete the comment.
If the context user has the Insert System Field Values for Chatter Feeds user permission, the create field property is available on CreatedBy and CreatedDate system fields. During migration, the context user can set these fields to the original post’s author and creation date. The fields can’t be updated after migration.

You can delete all feed items you created. To delete feed items you didn’t create, you must have one of these permissions:

Modify All Data
Modify All on the object associated with the feed and delete permission on the parent feed
Moderate Chatter
Users with the Moderate Chatter permission can delete only the feed items and comments they can see.
Note
Manage Unlisted Groups
Only users with this permission can delete items in unlisted groups.

Fields

Field	Details
CommentBody	Type textarea Properties Create, Filter, Sort, Update Description The text in the comment.
CommentType	Type reference Properties Create, Filter, Group, Nillable, Restricted picklist, Sort Description The type of comment: `ContentComment`—an uploaded file on a comment `TextComment`—a direct text entry on a comment Before API version 24.0, a text entry was required on a comment. As of version 24.0, a text entry is optional if the CommentType is `ContentComment`.
FeedItemId	Type reference Properties Create, Filter, Group, Sort Description ID of the feed item containing the comment.
HasEntityLinks	Type boolean Properties Defaulted on create, Filter, Group, Sort Description Indicates whether the feed CommentBody includes at least one link to a record. This field is available starting in API version 43.0. Note
InsertedById	Type reference Properties Filter, Group, Sort Description ID of the user who added this item to the feed. For example, if an application migrates posts and comments from another application into a feed, the InsertedBy value is set to the ID of the context user.
IsRichText	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether the feed CommentBody contains rich text. Set IsRichText to `true` if you post a rich text feed comment using the SOAP API. Otherwise, the comment is rendered as plain text. Rich text supports the following HTML tags: `<p>` Though the `<br>` tag isn’t supported, you can use `<p> </p>` to create lines. Tip `<b>` `<code>` `<i>` `<u>` `<s>` `<ul>` `<ol>` `<li>` `<img>` The `<img>` tag is accessible only through the API and must reference files in Salesforce similar to this example: <img src="sfdc://069B0000000omjh"></img> This attribute is available as of API version 38.0. In API version 38.0 and later, the system replaces special characters in rich text with escaped HTML. In API version 37.0 and prior, all rich text appears as a plain-text representation. Note
IsVerified	Type boolean Properties Defaulted on create, Filter, Group, Sort Description Determines whether a comment on a question is marked as Company Verified. This field is available in API version 41.0 and later.
LastEditById	Type reference Properties Create, Filter, Group, Nillable, Sort Description ID of the user who last edited the feed comment.
LastEditDate	Type datetime Properties Create, Filter, Nillable, Sort Description The date the feed comment was last edited.
ParentId	Type reference Properties Filter, Group, Nillable, Sort Description ID of a record associated with the feed comment. For example, if you are commenting on a change to a field on Account, ParentId is set to the account ID.
RelatedRecordId	Type reference Properties Create, Group, Nillable, Sort Description ID of the ContentVersion record associated with a `ContentComment`. This field is null for all comments except `ContentComment`. For example, set this field to an existing ContentVersion ID and set the CommentType to `ContentComment`.
Revision	Type int Properties Create, Filter, Group, Nillable, Sort Description The number of times the comment was revised.
Status	Type picklist Properties Create, Group, Nillable, Restricted picklist, Sort, Update Description Specifies whether this feed comment is published and visible to all who have access to the parent feed item. To make changes to a comment’s status, the comment’s parent feed item must be in a published state. This field is available in API version 38.0 and later. Possible values are: `Published`—The comment is visible to all who have access to the parent feed item. `PendingReview`—The comment is visible to its author and to users who can see the parent feed item and have View All Data or Can Approve Feed Post and Comment permission. The comment can be deleted by its author and users who can see the comment and have Can Approve Feed Post and Comment or Modify All Data permission. If the parent feed item is published, the comment can be edited by its author and users who can see the comment and have Can Approve Feed Post and Comment or Modify All Data permission. Comment status can be changed from Published to PendingReview and from PendingReview to Published by users who have Can Approve Feed Post and Comment or Modify All Data permission. Some actions are blocked when a feed comment is pending review: Select as Best—When a feed comment that is marked as best answer becomes unpublished, it’s removed as the best answer. If the comment is published, its best answer status is not restored. Like and unlike
SystemModstamp	Type datetime Properties Defaulted on create, Filter Description Date and time when a user or automated process (such as a trigger) last modified this record. In this context, "trigger" refers to Salesforce code that runs to implement standard functionality, and not an Apex trigger. SystemModstamp is a read-only system field, available in FeedComment as of API version 37.0.

Usage

As of API version 23.0 and later, if you have View All Data permission, you can query FeedComment records directly without an ID filter. If you don’t have View All Data permission, you can’t query FeedComment records directly, with or without an ID filter.
For example, the following query returns general information about a feed:
1SELECT ID, CreatedDate, CreatedById, CreatedBy.FirstName, 2 CreatedBy.LastName, ParentId, Parent.Name, Body 3FROM FeedItem 4WHERE CreatedDate > LAST_MONTH 5ORDER BY CreatedDate DESC, Id DESC

You can search for text in comments using SOSL. For example, the following Java class uses search() to find the string “foo” in any field of a record:

1public void searchSample() {
2  try {
3    SearchResult sr = connection.search("find {foo} in all fields " +
4        "returning feedcomment(Id, FeedItemId, CommentBody)");
5    // Put the results into an array of SearchRecords
6    SearchRecord[] records = sr.getSearchRecords();
7    // Check the length of the returned array of records to see
8    // if the search found anything
9    if (records != null && records.length > 0) {
10      System.out.println("Found " + records.length + " comments: ");
11      // Display each comment
12      for (SearchRecord record : records) {
13        FeedComment comment = (FeedComment) record.getRecord();
14        System.out.println(comment.getId() + ": " + 
15            comment.getCommentBody());
16      }
17    } else {
18      System.out.println("No records were found for the search.");
19    }
20  } catch (ConnectionException ce) {
21    ce.printStackTrace();
22  }
23}

If you use an Apex trigger to modify the Body of a FeedComment object, all mentions hyperlinks are converted to plain text. The mentioned users don't get email notifications.

This object is hard deleted. It isn’t sent to the Recycle Bin.

Note

Object Reference for Salesforce and Lightning Platform

FeedComment

Supported Calls

Special Access Rules

Fields

Usage

See Also