Skip to content

Support theme=dark|light via URL parameter #1517

@jules2689

Description

@jules2689

Describe the feature request

Currently, the theme in Gatus is determined by a cookie or the UI configuration. This works well in most cases, but it would be very useful to also support overriding the theme via a URL parameter, e.g.:

?theme=dark
?theme=light

Why do you personally want this feature to be implemented?

I embed Gatus inside an internal application using an <iframe>. In this setup, I’d like the parent application to control whether Gatus is displayed in dark or light mode, without relying on cookies or requiring user interaction inside Gatus itself (or worse getting a light flash at 11pm)

Supporting a URL-based theme override would make it easier to integrate Gatus into other UIs and ensure consistent theming across embedded contexts.

Happy to help with implementation or testing if this is something you’d consider adding 👍

How long have you been using this project?

Since July 2025

Additional information

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions