Announcements
Announcements are banners below the navigation bar, shown on every page to everyone, including signed-out visitors. Use them for planned maintenance, policy changes or incidents. Forgejo has no equivalent. Only site administrators can manage announcements.
Manage announcements
Section titled “Manage announcements”Open Site administration > Announcements (/admin/announcements).
The page lists every announcement with its status, and a form to add a new one.
Each announcement has these fields:
| Field | Meaning |
|---|---|
| Show announcement | Turns the announcement on or off without deleting it. |
| Message | The text, in Markdown, up to 500 characters. Preview shows the result. |
| Starts at (UTC, optional) | When the banner first appears. Empty means at once. |
| Ends at (UTC, optional) | When the banner stops appearing. Empty means never. Must be after the start. |
Select Save announcement to save one announcement, or Delete announcement to remove it. Saving or deleting one announcement does not change the others.
Several announcements can be active at once. They appear in the order of the list.
There is no app.ini setting.
The announcements are stored in the database, so every node of a high availability cluster shows the same ones.
Status
Section titled “Status”| Status | Meaning |
|---|---|
| Active | Shown now. |
| Scheduled | Enabled, and the start time is in the future. |
| Expired | Enabled, and the end time has passed. |
| Disabled | Show announcement is off. |
An announcement becomes active or expires automatically at the scheduled time. Visitors see the change on their next page load.
All times are in UTC, regardless of the time zone of your browser.
Markdown
Section titled “Markdown”The message supports the same Markdown as issues and comments, including formatting, links, lists and tables.
Relative links resolve against the instance’s root URL, so [status](/explore/repos) works on every page.
The rendered HTML is sanitised like any other Markdown in Forgejo.
Dismissed banners
Section titled “Dismissed banners”Each banner has a close button. A dismissed banner stays hidden in that browser, because the dismissal is stored in the browser’s local storage. It shows again in another browser, in a private window, or after the user clears site data.
When you edit an announcement, whether dismissed banners stay hidden depends on the change:
| Change | Dismissed banners |
|---|---|
| Start or end time | Stay hidden. |
| Message | Show again. |
| Turn Show announcement off and on again | Show again. |
Without JavaScript, banners are shown and cannot be dismissed.
Concurrent edits
Section titled “Concurrent edits”If another administrator has saved a change since you opened the page, Arbinel refuses your change and shows the current values. Review them and save again.