Supported way to hide the system time in a full-screen watchOS clock app?

I'm building a standalone watchOS app (SwiftUI, watch-only) whose main screen is its own full-screen clock. The system time in the top-right corner duplicates our clock, so we'd like to hide it while this view is visible. I'd like to know which API is supported for this in an App Store app.

What I tried (watchOS 27.2 SDK, Xcode 27.2):

  1. .persistentSystemOverlays(.hidden) on the root view and on the scene. The system time stays visible. In a variant with a NavigationStack and a hidden navigation bar, the time was briefly absent after launch, but it came back within about 20 seconds.
  2. .statusBarHidden(_:) and .toolbarVisibility(.hidden, for: .statusBar) are marked unavailable on watchOS in the SDK.
  3. View._statusBarHidden(_:) hides the system time reliably. In the watchOS SwiftUI interface it is public, available on watchOS since 6.0, and has no @_spi. It inlines to _statusBar(hidden:). However, it's underscored and I can't find documentation for it.

Minimal example:

struct ClockView: View {
    var body: some View {
        MyFullScreenClock()
            .persistentSystemOverlays(.hidden)   // documented, but time remains visible
            ._statusBarHidden(true)              // hides the time, but undocumented
    }
}

I've noticed this modifier in shipping open-source watchOS code, for example Home Assistant's watch app (Sources/WatchApp/Home/WatchHomeView.swift). That doesn't tell me whether Apple supports it, though.

Questions:

  1. Is _statusBarHidden(_:) / _statusBar(hidden:) a supported API for a distributed watchOS app?
  2. If not, is there a documented way for a full-screen clock app to hide the system time, or is the system time intentionally always shown in third-party apps?

I can share a small sample project that toggles between the documented overlay preference and the underscored modifier.

Thanks!

Answered by DTS Engineer in 917199022

I can't speak for App Review, but the methods starting with "_" (underscore) are private APIs, and in general, using private APIs risks a rejection.

There is no public API for developers to hide the system time on watchOS, and that's as-design because Apple Watch is a time piece, and so the time should always be there.

If you believe an alternative approach should be considered, I'd suggest that you to file a feedback report with information on how this design decision impacts you, and what you’d like to see done differently.

Although there is no promise that the behavior will be changed, it is the best way to ensure your thoughts on the matter are seen by the team responsible for the decision.

Best,
——
Ziqiao Chen
 Worldwide Developer Relations.

I can't speak for App Review, but the methods starting with "_" (underscore) are private APIs, and in general, using private APIs risks a rejection.

There is no public API for developers to hide the system time on watchOS, and that's as-design because Apple Watch is a time piece, and so the time should always be there.

If you believe an alternative approach should be considered, I'd suggest that you to file a feedback report with information on how this design decision impacts you, and what you’d like to see done differently.

Although there is no promise that the behavior will be changed, it is the best way to ensure your thoughts on the matter are seen by the team responsible for the decision.

Best,
——
Ziqiao Chen
 Worldwide Developer Relations.