Skip to Content

QB News

The QB News page is a built-in news reader that surfaces announcements and release notes published by the QuickBox team. Instead of checking external channels for updates, you can read everything directly inside the dashboard in a clean, searchable, split-pane layout.

The page lives at System > News in the sidebar and is accessible to admin users.

Admin only

QB News requires admin privileges. Specifically, you need the admin.system.update permission. If you do not see the News item in your sidebar, contact your server admin to verify your role and permissions.


Key features

📰 Split-Pane Layout

Browse announcements in a sidebar list on the left and read the full content in a viewer panel on the right — no page navigation required

🔍 Search and Filtering

Search across announcement titles and previews, and filter by type using the All, News, and Releases tabs

📝 Markdown Rendering

Announcement content is rendered as formatted markdown with full support for headings, lists, code blocks, links, and more

🔗 Deep Linking

Every announcement has a shareable URL. Copy a direct link to any announcement using the copy-link button in the viewer header

📡 Channel Aware

Announcements automatically match your server's update channel — stable, beta, or dev — so you always see the content relevant to your build

In-Browser Caching

Previously viewed announcements are cached in the browser session so switching between items is instant with no repeated network requests


Announcement types

QB News delivers two categories of content, each with a distinct badge in the sidebar list and viewer header:

TypeBadgeWhat it contains
News
Blue "News" badge
General platform announcements from the QuickBox team — new features, upcoming changes, service notices, and community updates
Release
Green "Release" badge
Version-specific release notes tied to QuickBox CLI updates — changelogs, bug fixes, new application support, and breaking change notices

Announcements are sorted newest-first by their publish date. When you open the News page, the most recent announcement is automatically selected and displayed.


Channel detection

The announcements you see depend on which update channel your server is running:

ChannelAnnouncement SourceIndicator
Stable
Public QuickBox GitHub repository
No badge — this is the default
Beta
Private release proxy at central.quickbox.io
Yellow "BETA Channel" badge in the sidebar
Dev
Private release proxy at central.quickbox.io
Yellow "DEV Channel" badge in the sidebar

Channel detection is automatic based on your server’s configured update channel. You do not need to change any settings — the News page reads the same channel that your CLI update system uses.

Channel badge

If your server is on the beta or dev channel, a colored badge appears at the top of the announcement list so you always know which channel you are viewing.


Using the News page

Browsing announcements

The left panel displays all available announcements as a scrollable list. Each item shows:

  • Title — extracted from the announcement content
  • Type badge — “News” (blue) or “Release” (green)
  • Preview — a short text excerpt of the announcement body
  • Date — the publish timestamp in human-readable format

Click any item to load its full content in the right-hand viewer panel.

Searching and filtering

Use the search field at the top of the sidebar to filter announcements by title or preview text. Below the search field, the segmented control tabs let you narrow the list:

  • All — Show every announcement
  • News — Show only general news announcements
  • Releases — Show only version release notes

Search and type filtering combine — you can search within a specific type by activating a tab and typing a query.

Each announcement updates the browser URL with a unique identifier (the ?id= parameter). To share a direct link to a specific announcement:

  1. Select the announcement you want to share
  2. Click the link icon button in the viewer header (top-right corner)
  3. The current page URL is copied to your clipboard

Anyone with admin access to the dashboard can open that link and land directly on the same announcement.


Server-side caching

The dashboard caches announcement data on the server to reduce upstream API calls and improve load times:

  • Announcement list — cached for 15 minutes
  • Individual announcement content — cached for 1 hour

This means newly published announcements may take up to 15 minutes to appear. Once an announcement appears in the list, clicking it loads the full content quickly because the server pre-fetches and caches content during the initial listing request.


FAQ

If the News page shows "No announcements found", the dashboard could not reach the upstream announcement source. On stable channel servers, this requires internet access to GitHub. On beta/dev channels, it requires connectivity to central.quickbox.io. Check your server's outbound network access if this persists.
News announcements are published as needed by the QuickBox team — there is no fixed schedule. Release notes are published alongside each QuickBox CLI version update.
No. The News page shows announcements matching your server's configured update channel only. If you are on the stable channel, you see stable announcements. Switching channels requires changing your server's update channel configuration.
The server caches the announcement list for 15 minutes to avoid excessive upstream API calls. A newly published announcement will appear within 15 minutes of its publication.
No. QB News requires the admin.system.update permission, which is only available to admin users. Regular users do not see the News item in the sidebar.
The News page shows announcements and release notes fetched from upstream — these are published by the QuickBox team and include general news alongside version-specific changelogs. The Changelog page focuses specifically on your server's installed version history and update operations.

Join the Community

Media server operators sharing configs, getting support, and shaping the future of QuickBox Pro.

Dedicated Support
Feature Previews
Community Configs
Active Discussions
Join Discord Server