ZenotiHelp

Startup and Reload Loading Screen

ZTZenoti Docs Team Updated October 16, 2026 5 min readGuide

The customer mobile app displays a loading screen at two distinct points: when the app first launches, and during subsequent in-app events such as sign-in, sign-up, pull-to-refresh, and center changes. Understanding how the loading screen behaves in each context helps you set guest expectations and configure branding assets appropriately.

Audience: Organization administrators and staff who manage the customer mobile app experience for guests.

Before you begin

  • Your organization must have published a customer mobile app for iOS, Android, or web.
  • To configure the splash logo that appears on the startup loading screen, work with your Zenoti account team. For branding setup instructions, see Multi-tenancy and app configuration.
  • The loading spinner's appearance (light or dark) is controlled by your organization's dark mode setting, not by the guest's device system theme. Confirm whether dark mode is enabled for your app before reviewing branding assets.

Steps

Understand startup loading screen behavior

When a guest opens the customer mobile app for the first time in a session (a full app launch), the app displays the startup loading screen. This screen has two elements:

  1. Branded splash image — Shown above the loading spinner when your organization has configured a splash logo. This image is your organization's branded asset.
  2. Loading spinner — Always present on the startup loading screen, centered below the splash image (or centered alone if no splash logo is configured).

Note: If your organization has not configured a splash logo, the startup loading screen shows only the loading spinner. No image placeholder or error message is displayed in place of the missing logo.

Understand reload loading screen behavior

During in-app loading events that reuse the loading screen — including sign-in, sign-up, pull-to-refresh, and center changes — the app displays only the loading spinner. The branded splash image does not appear during these reload events.

This distinction is intentional: once the app's home content has become ready for the first time, the app records that state. Every subsequent use of the loading gate — regardless of what triggered it — renders as spinner-only. This ensures that reload events do not read as the app restarting, so guests can clearly tell when the app is starting fresh versus loading new content within an existing session.

The following table summarizes the difference:

Loading context Splash image shown Loading spinner shown
Initial app launch (startup) Yes, if configured Yes
Initial app launch (no splash logo configured) No Yes
Sign-in No Yes
Sign-up No Yes
Pull-to-refresh No Yes
Center change No Yes

Understand loading spinner appearance

The loading spinner respects your app's own light or dark mode setting — not the guest's device system theme. This means:

  • When your organization has enabled dark mode for the customer mobile app, the spinner renders in its dark mode variant regardless of whether the guest's device is set to light or dark mode at the system level.
  • When dark mode is not enabled for your app, the spinner renders in its light mode variant regardless of the device system setting.

This behavior ensures the spinner remains visible against the loading screen background under all device brightness conditions. Because the spinner color is drawn from the app's branding mode rather than the device system brightness, the spinner cannot render invisibly against the loading screen background.

Note: Dark mode is an organization-level setting for the customer mobile app. Guests cannot toggle it independently within the app. Contact your Zenoti account team if you need to change the dark mode configuration for your app.

Configure the splash logo (admin task)

The splash logo displayed on the startup loading screen is the Splash Screen branding asset configured in your app template. To configure or update this image:

  1. Work with your Zenoti account team or refer to the branding setup documentation for image requirements and submission steps.
  2. Ensure your splash logo meets the resolution and format requirements for the Splash Screen image type. For details, see Multi-tenancy and app configuration.

Important: Changes to branding assets such as the splash logo require an app build and store submission. They do not take effect immediately after configuration.

Tips

  • Test both launch contexts after a branding update. After submitting a new splash logo, verify the behavior by force-closing the app and reopening it (startup launch — splash image should appear), then performing a sign-out and sign-in (reload event — splash image should not appear). This confirms the two loading contexts are behaving as expected.
  • Use a high-contrast splash logo. Because the startup loading screen background is fixed (light or dark based on your app's mode setting), choose a splash logo with sufficient contrast against both light and dark backgrounds if your organization may switch modes in the future.
  • Account for dark mode when reviewing spinner visibility. If guests report that the loading spinner is hard to see, check whether your app's dark mode setting matches your loading screen background color. The spinner color follows the app's mode, not the device theme, so a mismatch between your loading screen background and the spinner variant can reduce visibility.

Troubleshooting

Symptom Likely cause Resolution
The splash image appears during sign-in or pull-to-refresh, making it look like the app is restarting The app has not yet latched the home-content-ready state — this can occur if the app was terminated before the home screen fully loaded on the prior launch Force-close and reopen the app to complete a full startup cycle; if the behavior persists, contact your Zenoti account team to verify your app build is current
The splash logo is not appearing at app launch even though a logo has been configured The app build predates the logo configuration, or the logo did not meet image specifications Confirm that an app build and store submission occurred after the logo was configured; verify the image meets Splash Screen specifications
The loading spinner is not visible against the loading screen background Mismatch between the app's dark mode setting and the loading screen background color Review your dark mode configuration with your Zenoti account team; the spinner color follows the app's dark mode setting, not the device system theme
Guests report the app appears to restart every time they sign in Guests may be confusing the reload spinner (no splash image) with a startup event, or the splash image is incorrectly appearing during sign-in Verify that reload events (sign-in, sign-up, pull-to-refresh, center change) display only the spinner and not the splash image; contact your Zenoti account team if the splash image appears outside of startup
Was this article helpful?
Your feedback helps us improve our documentation.