Creating an Announcement
- Go to Admin → Content → Announcements.
- Click New Announcement.
- Fill in the fields described below.
- Set Active to on when ready to publish.
- Click Save.
Announcement Fields
| Field | Required | Notes |
|---|---|---|
| Title | Yes | Shown as the heading on the list and detail page |
| Slug | Yes | URL segment; auto-generated from title but editable |
| Body | Yes | Full content; supports Markdown and HTML |
| Published At | Yes | Date (and time) the announcement becomes visible |
| Pinned | No | Pinned announcements appear above all others regardless of date |
| Active | Yes | Toggle; inactive announcements are hidden from the portal |
Scheduled Publishing
Setting Published At to a future date and time acts as a scheduler. The announcement record is saved immediately, but it will not appear on /announcements or any homepage section until the published_at timestamp has passed.
[!IMPORTANT] Scheduling relies on the
published_atcolumn being in the past at render time. There is no background job that "flips" an announcement to visible — the portal simply excludes records wherepublished_at > now(). This means the announcement goes live at the correct time without any cron action.
Pinning Announcements
Enable Pinned to keep an announcement fixed at the top of the /announcements list above all other posts, regardless of its published_at date. Use this for critical notices that must remain prominent (e.g. an ongoing outage notice or a critical policy change).
Remove the pin once the notice is no longer urgent — too many pinned announcements dilutes the feature.
How Announcements Appear in the Portal
List page (/announcements): Each announcement is shown as a card with the title, publication date, and a truncated excerpt of the body. Older announcements are paginated.
Detail page (/announcements/{slug}): Full title, date, and complete body content.
Homepage section: The three most recent announcements (by published_at) are shown if the homepage section is enabled. Pinned announcements are included in this list.
[!TIP] Keep the first paragraph of the body self-contained and informative. It is used as the excerpt on the list page and on the portal homepage. Clients may only read the excerpt.
Editing an Announcement
Click the announcement title or the Edit action in the announcements list. All fields are editable after publishing. Changes take effect immediately.
Deleting an Announcement
Deleting an announcement is permanent and removes its URL. If clients have linked to or bookmarked the announcement, the link will 404.
[!WARNING] Prefer setting Active to off over deleting if there is any chance the URL has been shared. Inactive announcements are not visible in the portal but their record is preserved.
To delete, click Delete in the actions column and confirm with your admin password in the modal.