Updated: 10 November 2026 · Applies to: AzuraCast 0.24.0 (labels checked against the AzuraCast 0.24.0 source code and the official AzuraCast documentation; the custom CSS selectors apply to 0.19.0 and later)
To remove the "Powered by AzuraCast" footer, log in as an administrator, open Administration > Custom Branding (the /admin/branding page), tick Hide AzuraCast Branding on Public Pages and click Save Changes. On the same page you can upload your own background and browser icon, pick a theme and add custom CSS or JavaScript for the public player pages. No code changes are needed.
Hide the AzuraCast branding
- Log in with an account that can manage the whole system (the Super Administrator, or a role with administration rights).
- Open Administration, then Custom Branding under System Maintenance.
- Tick Hide AzuraCast Branding on Public Pages.
- Click Save Changes, then reload a station's public page (for example
https://radio.example.com/public/your_station) in a private browser window.
What this option changes, according to the AzuraCast source code:
- The "Powered by AzuraCast" footer disappears from the public pages (the player, schedule, song requests and the other pages that use the public layout).
- The browser tab title no longer ends in " - AzuraCast", so it shows only your station name.
What it does not change:
- The internal management panel that you and your DJs log in to still shows the AzuraCast name and logo. You can only restyle it with Custom CSS for Internal Pages.
- The browser icon stays the AzuraCast icon until you upload your own (see below).
- Stream metadata, the API and the admin URLs are not affected.
Replace the AzuraCast logo and images
Further down the Custom Branding page, Upload Custom Assets lets you replace three images for the whole server:
- Browser Icon: the small icon in the browser tab and on phone home screens. Upload your own logo here to replace the AzuraCast icon.
- Public Page Background: the background behind the public player.
- Default Album Art: shown when a song has no cover art of its own. You can also enter a Default Album Art URL instead.
Use Clear Image to go back to the default. To change the cover art of individual songs, edit the song in the station's media library, as described in how to change the image on the AzuraCast player page.
Other branding settings on the same page
- Base Theme for Public Pages: Light, Dark or Prefer System Default. If you plan to add custom CSS, AzuraCast recommends choosing Light or Dark, so your styles are not mixed with automatic theme switching.
- Hide Album Art on Public Pages: removes cover art from the public player.
- Homepage Redirect URL: sends visitors who open your AzuraCast address without logging in to your own website instead of the login screen.
Customise the public pages with CSS
Paste your styles into Custom CSS for Public Pages. The selectors below come from the AzuraCast documentation and use the [data-bs-theme] prefix that AzuraCast has used since version 0.19.0 (older guides use [data-theme], which no longer matches).
Change the background image:
[data-bs-theme] body.page-minimal {
background: url(https://example.com/my-background.jpg);
background-size: cover;
background-attachment: fixed;
}
Change the player card colour and the song title and artist text:
[data-bs-theme] body.page-minimal .public-page .card {
background-color: #5e0f16;
}
[data-bs-theme] body.page-minimal .public-page .card .now-playing-title {
color: #fff;
}
[data-bs-theme] body.page-minimal .public-page .card .now-playing-artist {
color: #fefefe;
}
Every public page carries a body class named after the station's URL stub, station-<short name>. A station called "My Radio" gets station-my_radio, so you can style one station only:
[data-bs-theme] body.station-my_radio .public-page .card {
background-color: #1d3557;
}
For anything else, right-click the element on your public page and choose Inspect to find its class name.
Add custom JavaScript
Custom JS for Public Pages runs on the station public pages and the login page. Use it for small additions such as an analytics snippet. AzuraCast's documentation also shows how to add a background video with it. Test any script carefully: a broken script can stop the player page from working.
Branding for one station only
Each station also has its own branding page: open the station, then Public Pages > Branding. It offers Station Offline Display Text, Default Album Art URL, and custom CSS and JavaScript that apply to that station's public pages only. The "Hide AzuraCast Branding" switch itself is system-wide and only on the Administration page.
Why not edit the AzuraCast files instead?
The AzuraCast documentation gives the Custom Branding page as the way to customise the public pages; it does not describe a supported way to edit the program's own templates. AzuraCast runs from Docker images that are replaced on each update, so changes made inside them would be lost. Keep your changes in the branding settings, which are stored in the database and survive updates.
On a Ucartz AzuraCast hosting plan, if the Custom Branding menu is not available to your login, open a support ticket and our team will apply the setting for you. For the player name shown on the page, see how to change the radio name on the AzuraCast player.
Official documentation: Using Custom CSS, Using Custom JavaScript.