Announcements
Create, schedule, publish, email, pin, expire, edit, and delete board announcements.
Overview
Announcements let the board publish updates to residents through the portal, email, or both. Secretary-level access is required to create, edit, publish, and delete announcements.
Published portal announcements appear on the resident dashboard and Updates page.
Announcement Channels
| Channel | Behavior |
|---|---|
| Portal | Visible in resident portal only |
| Sent by email only | |
| Both | Visible in portal and sent by email |
Only portal and both announcements appear in resident portal views.
Draft, Scheduled, and Published
An announcement can be:
- Draft - created but not published.
- Scheduled - set to publish in the future.
- Published - sent immediately or after scheduled publishing.
- Expired - hidden from residents after its expiration date.
- Deleted - removed from active board/resident views.
Scheduled announcements are handled by the publish-announcements cron job.
Creating an Announcement
When creating an announcement, choose:
- Title
- Body
- Channel
- Scheduled publish date/time, optional
- Expiration date/time, optional
- Pinned flag
- Whether to publish now
If publishing immediately and the channel includes email, SyncHOA attempts email delivery and stores delivery counts.
Email Delivery
Email delivery records:
- Recipient count
- Delivered count
- Failed count
- Delivery status
- Last sent timestamp
Delivery depends on valid resident email addresses and the configured email provider.
Pinned Announcements
Pinned announcements appear ahead of unpinned announcements in resident portal feeds. Use pinned updates for critical or long-lived notices.
Editing Announcements
Draft and scheduled announcements can have schedule information updated. Published announcements keep their published state, and schedule fields are cleared.
Editing logs before/after metadata in the audit trail.
Publishing Existing Announcements
Publishing an existing draft:
- Sets the sent timestamp.
- Clears scheduled date.
- Sends announcement emails when channel requires it.
- Updates email delivery fields.
- Revalidates board and resident announcement pages.
Deleting Announcements
Deleting an announcement soft-deletes it. Deleted announcements stop appearing in resident portal lists. The audit trail records the title and channel.