FeedItem

FeedItem represents an entry in the feed, such as changes in a record feed, including text posts, link posts, and content posts. This object is available in API version 21.0 and later. This object replaces FeedPost.

Supported Calls

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

Special Access Rules

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”
  • “Moderate Chatter”
    Note

    Note

    Users with the “Moderate Chatter” permission can delete only the feed items and comments they see.

  • “Manage Unlisted Groups”

    Only users with this permission can delete items in unlisted groups.

Only users with the “Modify All Data” permission can delete a FeedItem of Type TrackedChange.

If the logged-in 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 logged-in user can set these fields to the original post’s author and creation date. The fields can’t be updated after migration.

Fields

Field Name Details
BestCommentId
Type
reference
Properties
Filter, Group, Nillable, Sort
Description
The Id of the comment marked as best answer on a question post.
Body
Type
textarea
Properties
Create, Nillable, Sort, Update
Description
The content of the FeedItem. Required when Type is TextPost or AdvancedTextPost. Optional when Type is ContentPost or LinkPost. This field is the message that appears in the feed.
Although a value for Body is not required for the ContentPost type, an attachment is required. If an attachment isn’t present, the type changes to TextPost or AdvancedTextPost, depending on the API version. TextPost and AdvancedTextPost do require a value for Body.
Tip

Tip

See the IsRichText field for a list of HTML tags supported in the body of rich text posts.

CommentCount
Type
int
Properties
Filter, Group, Sort
Description
The number of FeedComments associated with this feed item.
Tip

Tip

In a feed that supports pre-moderation, CommentCount isn’t updated until a comment is published. For example, say that you comment on a post that already has one published comment and your comment triggers moderation. Now there are two comments on the post, but the count says there's only one. In a moderated feed, your comment isn’t counted until it's approved by an admin or a person with “CanApproveFeedPostAndComment” or “ModifyAllData” permission.

Feed moderation has implications on how you retrieve feed comments. In a moderated feed, rather than retrieving comments by looping through CommentCount, go through pagination until end of comments is returned.

ConnectionId
Type
reference
Properties
Filter, Group, Nillable, Sort
Description
When a PartnerNetworkConnection modifies a record that is tracked, the CreatedBy field contains the ID of the system administrator. The ConnectionId contains the ID of the PartnerNetworkConnection. Available if Salesforce to Salesforce is enabled for your organization.
ContentData
Type
base64
Properties
Create, Nillable
Description
This field was removed in API version 35.0, and is available in earlier versions for backward compatibility only. This field is required if Type is ContentPost. Encoded file data in any format, and can’t be 0 bytes. Setting this field automatically sets Type to ContentPost.
ContentDescription
Type
textarea
Properties
Create, Nillable, Sort
Description
This field was removed in API version 35.0, and is available in earlier versions for backward compatibility only. The description of the file specified in ContentData.
ContentFileName
Type
string
Properties
Create, Group, Nillable, Sort
Description
This field was removed in API version 35.0, and is available in earlier versions for backward compatibility only. The name of the file uploaded to the feed. Setting ContentFileName automatically sets Type to ContentPost.
ContentSize
Type
int
Properties
Group, Nillable, Sort
Description
This field was removed in API version 35.0, and is available in earlier versions for backward compatibility only. This field is the size of the file (in bytes) uploaded to the feed. This field is read-only and is automatically determined during insert.
ContentType
Type
string
Properties
Group, Nillable, Sort
Description
This field was removed in API version 35.0, and is available in earlier versions for backward compatibility only. This field is the MIME type of the file uploaded to the feed. This field is read-only and is automatically determined during insert.
FeedPostId
Type
reference
Properties
Filter, Group, Nillable, Sort
Description
This field was removed in API version 22.0, and is available in earlier versions for backward compatibility only.

ID of the associated FeedPost. A FeedPost represents the following types of changes in an FeedItem: changes to tracked fields, text posts, link posts, and content posts.

HasContent
Type
boolean
Properties
Defaulted on create, Filter, Group, Sort
Description
Indicates whether the feed item has content.
HasFeedEntity
Type
boolean
Properties
Defaulted on create, Filter, Group, Sort
Description
Indicates whether the feed item has a feed entity, for example, a post, as an attachment. Available in API version 39 and later when sharing a feed entity in Lightning Experience.
HasLink
Type
boolean
Properties
Defaulted on create, Filter, Group, Sort
Description
Indicates whether the feed item has a link attached.
HasVerifiedComment
Type
boolean
Properties
Defaulted on create, Filter, Group, Sort
Description
Determines whether a question has an answer that is marked as Company Verified.

This field is available in API version 41.0 and later.

InsertedById
Type
reference
Properties
Filter, Group, Nillable, Sort
Description
ID of the user who added this object 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 logged-in user.
IsClosed
Type
boolean
Properties
Defaulted on create, Filter, Group, Sort
Description
As of API version 43, a read-only field that indicates whether the Feed Item is open or closed to new actions. A value of true places restrictions on the actions a user can take on a feed item and its comments. For more information, see the Usage section.
IsDeleted
Type
boolean
Properties
Defaulted on create, Filter, Group, Sort
Description
Standard system field. Indicates whether the record has been moved to the Recycle Bin (true) or not (false).
IsRichText
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort, Update
Description
Indicates whether the feed item Body contains rich text. Set IsRichText to true if you post a rich text feed item via SOAP API. Otherwise, the post is rendered as plain text.

Rich text supports the following HTML tags:

  • <p>
    Tip

    Tip

    Though the <br> tag isn’t supported, you can use <p>&nbsp;</p> to create lines.

  • <b>
  • <code>
  • <i>
  • <u>
  • <s>
  • <ul>
  • <ol>
  • <li>
  • <img>

    The <img> tag is accessible only via the API and must reference files in Salesforce similar to this example: <img src="sfdc://069B0000000omjh"></img>

Note

Note

In API version 35.0 and later, the system replaces special characters in rich text with escaped HTML. In API version 34.0 and prior, all rich text appears as a plain-text representation.

LastEditById
Type
reference
Properties
Create, Filter, Group, Nillable, Sort
Description
ID of the user who last edited the feed item.
LastEditDate
Type
datetime
Properties
Create, Filter, Nillable, Sort
Description
The date the feed item was last edited.
LikeCount
Type
int
Properties
Filter, Group, Sort
Description
The number of FeedLikes associated with this feed item.
LinkUrl
Type
url
Properties
Create, Nillable, Sort
Description
The URL of a LinkPost.
NetworkScope
Type
picklist
Properties
Create, Filter, Group, Nillable, Restricted picklist, Sort
Description
Specifies whether this feed item is available in the default community, a specific community, or all communities. This field is available in API version 26.0 and later, if Salesforce Communities is enabled for your organization.
NetworkScope can have the following values:
  • NetworkId—The ID of the community in which the FeedItem is available. If left empty, the feed item is only available in the default community.
  • AllNetworks—The feed item is available in all communities.
Note the following exceptions for NetworkScope:
  • Only feed items with a Group or User parent can set a NetworkId or a null value for NetworkScope.
  • For feed items with a record parent, users can set NetworkScope only to AllNetworks.
  • You can’t filter a FeedItem on the NetworkScope field.
ParentId
Type
reference
Properties
Create, Filter, Group, Sort
Description
ID of the object type to which the FeedItem object is related. For example, set this field to a UserId to post to someone’s profile feed, or an AccountId to post to a specific account.
RelatedRecordId
Type
reference
Properties
Create, Group, Nillable, Sort
Description
ID of the ContentVersion object associated with a ContentPost. For Work.com thanks posts, it’s the ID of the WorkThanks object associated with a RypplePost. This field is typically null for all posts except ContentPost and RypplePost.

For example, set this field to an existing ContentVersion and post it to a feed as a FeedItem object of Type ContentPost.

Revision
Type
int
Properties
Create, Filter, Group, Nillable, Sort
Description
The revision number of the feed item.
Status
Type
picklist
Properties
Create, Group, Nillable, Restricted picklist, Sort, Update
Description
Specifies whether this feed item is published and visible to all who have access to the feed. This field is available in API version 37.0 and later.
Possible values are:
  • Published—The feed item is visible to all who have access to the feed.
  • PendingReview—The feed item is visible to its author and to users who can see the item and have “ViewAllData” or “CanApproveFeedPostAndComment” permission. The feed item author and users who can see the item and have “CanApproveFeedPostAndComment” or “ModifyAllData” permission can delete and edit the feed item.
    Some actions are blocked when a feed item is pending review:
    • Comment
    • Like/unlike
    • Bookmark
    • Share
Title
Type
string
Properties
Create, Group, Nillable, Sort, Update
Description
The title of the FeedItem. When the Type is LinkPost, the LinkUrl is the URL and this field is the link name. The Title field can be updated on posts of Type QuestionPost.
Type
Type
picklist
Properties
Create, Filter, Group, Nillable, Restricted picklist, Sort
Description
The type of FeedItem. Except for ContentPost, LinkPost, and TextPost, don’t create FeedItem types directly from the API.
  • ActivityEvent—indirectly generated event when a user or the API adds a Task associated with a feed-enabled parent record (excluding email tasks on cases). Also occurs when a user or the API adds or updates a Task or Event associated with a case record (excluding email and call logging).

    For a recurring Task with CaseFeed disabled, one event is generated for the series only. For a recurring Task with CaseFeed enabled, events are generated for the series and each occurrence.

  • AdvancedTextPost—created when a user posts a group announcement and, in Lightning Experience as of API version 39.0 and later, when a user shares a post.
  • AnnouncementPost—Not used.
  • ApprovalPost—generated when a user submits an approval.
  • BasicTemplateFeedItem—Not used.
  • CanvasPost—a post made by a canvas app posted on a feed.
  • CollaborationGroupCreated—generated when a user creates a public group.
  • CollaborationGroupUnarchived—Not used.
  • ContentPost—a post with an attached file.
  • CreatedRecordEvent—generated when a user creates a record from the publisher.
  • DashboardComponentAlert—generated when a dashboard metric or gauge exceeds a user-defined threshold.
  • DashboardComponentSnapshot—created when a user posts a dashboard snapshot on a feed.
  • LinkPost—a post with an attached URL.
  • PollPost—a poll posted on a feed.
  • ProfileSkillPost—generated when a skill is added to a user’s Chatter profile.
  • QuestionPost—generated when a user posts a question.
  • ReplyPost—generated when Chatter Answers posts a reply.
  • RypplePost—generated when a user creates a Thanks badge in Work.com.
  • TextPost—a direct text entry on a feed.
  • TrackedChange—a change or group of changes to a tracked field.
  • UserStatus—automatically generated when a user adds a post. Deprecated.
The following values appear in the Type picklist for all feed objects but apply only to CaseFeed:
  • AttachArticleEvent—generated event when a user attaches an article to a case.
  • CallLogPost—generated event when a user logs a call for a case through the user interface. CTI calls also generate this event.
  • CaseCommentPost—generated event when a user adds a case comment for a case object.
  • ChangeStatusPost—generated event when a user changes the status of a case.
  • ChatTranscriptPost—generated event when Live Agent transcript is saved to a case.
  • EmailMessageEvent—generated event when an email related to a case object is sent or received.
  • FacebookPost—generated when a Facebook post is created from a case. Deprecated.
  • MilestoneEvent—generated when a case milestone is completed or reaches violation status.
  • SocialPost—generated when a social post is created from a case.
Note

Note

If you set Type to ContentPost, also specify ContentData and ContentFileName.

Visibility
Type
picklist
Properties
Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
Specifies whether this feed item is available to all users or internal users only. This field is available in API version 26.0 and later, if Salesforce Communities is enabled for your organization.
Visibility can have the following values:
  • AllUsers—The feed item is available to all users who have permission to see the feed item.
  • InternalUsers—The feed item is available to internal users only.
Note the following exceptions for Visibility:
  • For record posts, Visibility is set to InternalUsers for all internal users by default.
  • External users can set Visibility only to AllUsers.
  • Visibility can be updated on record posts.
  • The Update property is supported only for feed items posted on records.

Usage