---
schema_version: "1"
id: 281b8070722d452b5775786e27d9868f404bec4c28609b7b91fce5114f8be264
title: Announcement
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_announcement.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_announcement.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 9ee5e1b39bae0d53b37ac9462019b5444ebe95db004975eb236fd3d7a6332cde
description: Represents a Chatter group announcement. This object is available in API version 30.0 and later.
---
# Announcement

Represents a Chatter group announcement. This object is available in API version 30.0 and later.

## Supported Calls

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

## Fields

| Field Name | Details |
| --- | --- |
| ExpirationDate | 
Type

dateTime

Properties

Create, Filter, Sort, Update

Description

Required. The date on which the announcement expires. Announcements display on the group UI until 11:59 p.m. local time on the selected date.





 |
| FeedItemId | 

Type

reference

Properties

Create, Filter, Group, Sort

Description

Required. The ID of the FeedItem that contains the content of the announcement. Announcements are stored as text posts.

This is a relationship field.

Relationship Name

FeedItem

Relationship Type

Lookup

Refers To

FeedItem



 |
| ParentId | 

Type

reference

Properties

Filter, Group, Nillable, Sort

Description

The ID of the parent CollaborationGroup that the announcement belongs to. An announcement can belong only to a single Chatter group.

This is a relationship field.

Relationship Name

Parent

Relationship Type

Lookup

Refers To

CollaborationGroup



 |
| SendEmails | 

Type

boolean

Properties

Defaulted on create, Filter, Group, Sort

Description

Set to true to email all group members when an announcement is posted to the group. The default is false. This requires the user to have the “Send announcement on email” permission.

This field is available in API version 36.0 and later.

![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png)

#### Note

This field is currently available to select customers through a pilot program. To be nominated to join this pilot program, contact Salesforce. Additional terms and conditions may apply to participate in the pilot program. Please note that pilot programs are subject to change, and as such, we cannot guarantee acceptance into this pilot program or a particular time frame in which this feature can be enabled. Any unreleased services or features referenced in this document, press releases, or public statements are not currently available and may not be delivered on time or at all. Customers who purchase our services should make their purchase decisions based upon features that are currently available.















 |

## Usage

Group owners, managers, and users with the “Modify All Data” permission can use the Announcement object to create, edit, and delete group announcements. Creating a group announcement is a three-step process.

1. Use the FeedItem object to create a text post with the announcement’s content. Use the CollaborationGroup record you want to post the announcement to as the parent of this feed item.
2. Next, use the feed item ID and an expiration date to create the announcement record.
3. Finally, update the AnnouncementId field in the CollaborationGroup record with the ID of the announcement you created.

To delete the group announcement, simply delete the AnnouncementId value in the CollaborationGroup record. To restore a group announcement, update the AnnouncementId field for a group with the announcement’s ID. The expiration date for the announcement should be in the future and the feed item used to create the announcement should be parented by the same group.