Announcements

What an announcement is

An announcement is a short Markdown-formatted notice written by a LocallyGrown superuser and shown to every market administrator across every market. We use them for things like:

• A new feature landing that managers should know about (e.g. the queue monitor, the impersonation audit log).
• A scheduled maintenance window, a deprecation notice, or a change in how an existing feature behaves.
• Occasional urgent alerts — a security advisory, a payment-processor outage, or anything else that needs attention the same day.

Each announcement has a priority (info, important, or urgent), an optional expiration date, and an active flag. Priority drives the visual treatment; expiration causes the announcement to automatically stop appearing after the chosen time.

Where you'll see them as a manager

If you're a market admin or manager, announcements show up in two places:

1. A modal popover on your first visit

When a new announcement is published, the next time you load any page as an admin you'll see a modal overlay with the announcement's title, rendered content, and priority badge. If there are multiple unread announcements, you'll step through them one at a time.

Dismissing the modal (the X, the Dismiss button, or clicking outside) records that you've seen it — for you specifically. It won't pop up again on your account. Other managers in your market have their own dismissal state and will still see it on their next visit.

2. The Recent Announcements panel on your admin dashboard

Inside the Market Manager panel, the Quick Actions section shows the five most recent active announcements with their titles and priority badges — regardless of whether you've dismissed them. Think of it as a persistent log; if you dismissed a modal too quickly and want to re-read it, look here.

Dismissing and re-reading

• Dismissal is per-user, not per-market. If you manage multiple markets, you'll see each announcement once across all of them, not once per market.
• Dismissal is sticky. There's no "mark as unread" — once you dismiss, the modal won't come back. Use the Recent Announcements panel to revisit the content.
• Deactivated or expired announcements disappear from both surfaces. A superuser can deactivate an announcement at any time, and anything past its expiration date stops appearing even if it's still marked active.

Authoring announcements (superuser only)

Creating, editing, and deleting announcements is restricted to LocallyGrown superusers. Market managers — even managers of multiple markets — can't author announcements and shouldn't need to; the channel is deliberately platform-to-manager, not manager-to-manager.

If you're a superuser, the authoring UI lives at /admin/announcements/. The page lists every announcement ever created with its current state, and provides buttons for New Announcement, Edit, Activate / Deactivate, and Delete.

Fields

• Title. Short, headline-style. Shown in the modal header and in the Recent Announcements list.
• Content. Markdown. Run through the same sanitizer used elsewhere in the app, so arbitrary HTML and scripts are stripped. There's a preview endpoint (used by the editor) so you can see the rendered output before saving.
• Priority. info (blue), important (amber), or urgent (red). This controls the badge color on the modal and the Recent Announcements list — pick the lowest priority that honestly represents the message.
• Expires at. Optional date/time. After this moment the announcement stops appearing to anyone, without you having to go back and deactivate it manually. Use it for anything tied to a specific event (maintenance window, time-limited offer).
• Active. Toggle off to pull the announcement immediately without deleting it. Useful if you published something with a typo and want to fix it offline before re-enabling.

When not to use an announcement

• Per-market or per-manager messages. Announcements go to every manager on every market. If it's really just for one market, email the manager directly.
• Anything customer-facing. Customers never see announcements.
• Long-form content. The modal is a one-screen read; for anything more substantial, link out to a documentation page and keep the announcement itself short.