Branding settings let you control everything a viewer sees before the stream connects: the logo, splash background, loading animation, and the text shown during waits, idles, and errors. Configure them per project from the dashboard.Documentation Index
Fetch the complete documentation index at: https://docs.streampixel.io/llms.txt
Use this file to discover all available pages before exploring further.
What’s customizable
| Element | Description |
|---|---|
| Logo | Shown in the corner of the loading screen and overlays. SVG or PNG. |
| Splash background | Full-screen image displayed while the stream is connecting. |
| Loading animation | Visual style of the spinner / progress indicator. |
| Loading message | Text shown while the stream is starting. |
| Queue message | Text shown when the user is waiting in the queue. |
| AFK warning | Text shown before an idle user is disconnected. |
| Error message | Text shown when something goes wrong. |
Logo
Upload your logo from Project Settings → Branding → Logo.| Property | Recommendation |
|---|---|
| Format | SVG (preferred — scales crisply) or PNG with transparency |
| Aspect ratio | Square (1:1) for icon-style logos, or 10:3 horizontal for wordmarks |
| Recommended size | 200×200 for square logos, 600×180 for horizontal |
| Max file size | 2 MB |
| Background | Transparent — the logo is composited over your splash background |
Splash background
The splash is the full-screen image visitors see before the stream is ready.| Property | Recommendation |
|---|---|
| Format | JPG, PNG, or WebP |
| Recommended dimensions | 1920×1080 (16:9) |
| Max file size | 5 MB |
| Color depth | sRGB |
Avoid important content near the edges — different viewport ratios will crop the image. Keep your hero artwork centered.
Animation styles
Pick how the loading indicator appears on top of the splash.Spinner
Classic rotating ring. Best for most projects.
Pulse
Soft expanding circles. Works well over photographic backgrounds.
Fade
Gentle opacity loop. Minimal and unobtrusive.
Custom text
Override the default copy for each user-facing message.| Field | Default | When it appears |
|---|---|---|
| Loading message | ”Loading your experience…” | While the stream is connecting |
| Queue message | ”You are in the queue. Please wait…” | When all servers are busy and the user is queued |
| AFK warning | ”Are you still there?” | Just before an idle user is disconnected |
| Error message | ”Something went wrong. Please refresh.” | After a fatal connection error |
Preview before publishing
Use the Preview button at the bottom of the Branding tab to see exactly what visitors will see, with your logo, splash, animation, and messages composited together. The preview opens in a new tab against the live build, so you can iterate without affecting end users. When the preview looks right, click Save. Changes are applied to all new sessions immediately — currently connected users keep their existing UI until they reload.Resetting to default
Each branding field has a Reset action that restores the Streampixel default. Resetting one field does not affect the others, so you can roll back the splash image without losing your custom messages.Going further
The dashboard branding controls cover the common cases. For complete control over the loading UI — custom HTML, CSS animations, video splashes, or interactive elements — use the SDK-level customization.Custom loading UI
Replace the loading screen entirely with your own HTML and CSS.
SDK custom loading screen
Programmatic control over loading state in the Web SDK.
Troubleshooting
| Problem | Fix |
|---|---|
| Logo looks blurry | Upload a higher-resolution PNG, or switch to SVG. |
| Splash image is cropped weirdly on mobile | Move the focal point closer to center, or use 1080×1920 portrait if your audience is mobile-first. |
| Custom message shows the default text | Make sure you saved after editing — the Save button must turn green. Also hard-refresh the share page. |
| Color picker for the animation does nothing | The selected animation style may not support a custom color. Try Spinner. |
| Upload fails | Check the file is under the size limit and uses a supported format. |
Next steps
Custom domains
Pair your branding with your own domain.
Sharing and embedding
Embed the branded experience on your own site.
Custom loading UI
Take full control with custom HTML and CSS.
Web SDK overlays
Add branded overlays on top of the live stream.