Overview
Announcements surface in two places in the client portal: the homepage section and the announcements archive at /announcements. Each serves a different purpose.
Portal Homepage Section
The homepage can display the most recent announcements in a dedicated section. Enable or disable this section in Admin → Settings → Client Portal → Homepage Sections.
When enabled:
- The three most recent active announcements (by
published_at) are shown. - Pinned announcements always appear in this section while they are active, even if older than the three most recent.
- Each card shows the announcement title, date, and an excerpt.
- A "View all announcements" link directs clients to
/announcements.
[!TIP] If you post announcements infrequently, consider disabling the homepage section so the portal homepage does not show a stale announcement from months ago. Enable the section during active communication periods.
Announcements Archive (/announcements)
The archive page lists all active announcements in reverse chronological order. Pinned announcements appear at the top, followed by remaining announcements ordered by published_at descending.
Pagination: Announcements are paginated (15 per page by default). Older announcements are accessible by navigating through pages.
Columns displayed per card:
| Element | Notes |
|---|---|
| Title | Links to the individual announcement page |
| Date | Formatted published_at date |
| Excerpt | First ~200 characters of the body |
| Pinned badge | Shown on pinned announcements |
Individual Announcement Page (/announcements/{slug})
Each announcement has a dedicated detail page that renders the full body content. The slug is set when creating the announcement and can be changed later (existing links will break if the slug changes).
The page renders Markdown and HTML in the body field, so you can use headings, code blocks, tables, and links.
[!IMPORTANT] Changing an announcement's slug after publishing breaks the old URL. If you have shared the link in an email or ticket, clients following the old link will get a 404. Only change slugs before an announcement is published or communicated.
Read More Link
On the list page and homepage section, each announcement card includes a Read more link pointing to /announcements/{slug}. This link is always present — there is no option to hide it.
RSS Feed
If your Commerce installation has the RSS feed enabled, published announcements are included in the feed at /announcements/feed.rss. Clients can subscribe to this feed with any RSS reader to receive announcement updates without checking the portal. Enable or disable the RSS feed in Admin → Settings → Client Portal → Features.
Announcements and Inactive Clients
Announcements are publicly visible — no login is required to read /announcements or individual announcement pages. This means former clients or prospects can also see your announcements without an account.