Branding
Settings → Branding (/app/w/{workspace}/settings/branding). Permission workspace.update. Logos live on the public storage disk (storage:link required for local disks). Maximum upload 2048 KB. Do not paste logos into .env.
This is not a white-label rebuild of the product name “Veldriq”, the Field store listing, or Platform Admin website/legal pages. Changing a logo does not rewrite old Generated PDFs (snapshots are frozen at generate).
This public documentation site uses Cnone-Tech chrome, not your workspace logo.
The Arabic RTL office UI is on Localization. This page has no approved screenshot of the branding form.
Not the same as native Field fallback
Section titled “Not the same as native Field fallback”Veldriq Web (CMS, portal, public booking, mail, Field PWA) can fall back through tenant logo → collapsed icon → platform logo.
Native Veldriq Field does not. If the workspace has no usable logo_url, the phone shows the compiled branding/fallback_logo.png from that Field binary — not the platform logo. Launcher icon and native splash stay in the binary until you rebuild Field. See Field branding.
Fields
Section titled “Fields”Settings → Branding:
| Control | Native Field uses it? |
|---|---|
| Logo | Yes (logo_url after login / session fetch) |
| Collapsed icon | No (logo_icon_url may be sent; Field UI ignores it) |
| Primary / Accent | Yes (Material theme) |
| Sidebar, top bar, canvas, fonts, corner radius, density | No (CMS / portal / PWA) |
Malformed hex colors are ignored. Native Field then uses slate fallbacks #0F172A / #334155 inside the app — not the CMS canvas tokens.
Where the logo appears
Section titled “Where the logo appears”| Setting | CMS | Portal | Public booking | Emails | PDFs | Field PWA | Native Field |
|---|---|---|---|---|---|---|---|
| Workspace logo | Yes (else icon, else platform logo; collapsed rail may show tenant initial) | Yes; if missing, company name as text (no initial) | Yes (guest∥icon∥platform; else company initial) | Branded mail (tenant→icon→platform; else text brand name) | Snapshot at generate; if no image, name only | Theme CSS + chrome (tenant∥platform; else workspace initial) | Yes after session; else compiled fallback PNG. Never platform logo |
| Primary / accent | Yes | Yes (guest CSS) | Yes | Primary for chrome; else platform #E7663B |
Snapshot primary (service-report template may default #2563eb if absent) |
Theme CSS | Yes — or slate fallbacks |
| Collapsed icon, sidebar, fonts, radius | Yes (subset) | Partial | Partial | — | — | Partial | No |
| Product name “Veldriq” | No | No | No | No | No | Boot HTML title is build-time | No — launcher + APP_DISPLAY_NAME are build-time |
- Open the workspace → Settings → Branding.
- Upload Logo (and optionally Collapsed icon) as image files. Keep
php artisan storage:linkhealthy on local disks. - Set Primary and Accent (and CMS-only chrome if you use it).
- Save. Office CMS and portal pick up the theme on the next page load.
- Native Field: sign in again, switch workspace, or wait for the next successful session fetch. No Field rebuild. Push does not deliver a new logo.
If the CMS still shows the old logo: public disk / CDN cache, or you looked at a Generated PDF issued before the change.
If Field still shows the compiled PNG: the session has no http(s) logo_url, the image 404s, or you never completed a session on this device. Uploading only the collapsed icon does not change native Field.
Related: Settings, Field PWA, Field branding.