Whitelabel

Add your logo, app icon and wordmark

Your brand appears on the sign-in screen and throughout the app's navigation. There are two separate image uploads, and the reason they are separate is the thing most people get wrong.

4 min read · 1 screenshot

On the Whitelabel page, the second card is Your brand. Unlike the domain, everything here stays editable for the life of the partnership — including after you are live.

The Your brand card on the OroPocket whitelabel page, with a Wordmark text field, a Logo upload with a wide preview box, an App icon upload with a square preview box, and an accent colour field.
Wordmark, logo, square app icon, accent colour. A logo or a wordmark is required before you can submit.
FieldTypeDescription
wordmarkstring (32)requiredYour name in text. Used when there is no logo, and as the logo's alt text — so fill it in even if you upload a logo.
logoPNG / JPEG / WebPoptionalYour horizontal lockup, for the sign-in screen and the app navigation. A transparent background reads best.
app iconsquare PNG, ≥512pxoptionalThe browser tab favicon and the icon someone gets when they install your site to a phone home screen.
accent#RRGGBBoptionalReserved for a future themed build. The app is black and white today, so setting this changes nothing yet.
  1. Write the wordmark

    Up to 32 characters. It is the fallback when there is no logo, and it is the alt text on the logo when there is one — so it is doing accessibility work whichever way you go.

  2. Upload the horizontal logo

    Upload opens a file picker; the preview box next to it shows what we hold. Replace and Remove appear once something is there. Files can be up to 25 MB, though a logo has no business being anywhere near that.

  3. Upload a separate square icon

    This is the one worth getting right. A wide lockup squeezed into a 16-pixel favicon is unreadable, and letterboxed on a phone home screen it looks broken — which is exactly why this is a second upload rather than a crop of the first. Supply a genuinely square image, at least 512 pixels, with the artwork centred.

  4. Save

    Before your domain is live, Save applies the change directly. Once you are live the button becomes Submit brand for review — see below.

Why editing a live brand goes through review

Once your domain is serving, a brand change is staged rather than applied. Your site keeps showing the approved brand while the new one waits, and an administrator copies it across on approval. There is no deploy and no downtime.

The staging exists so that reviewing a logo can never take a site down. The alternative — moving your whole request back into review — would drop your domain out of the CORS allow-list and blank your branding, which is a lot of blast radius for a new PNG.

While a change is pending, the card shows a banner saying so. If it is rejected you get the reviewer’s note in red, and your live brand is untouched throughout.

What your users see, and what they do not

On your domain, your users see your wordmark and logo in the sign-in screen and the app navigation. They do not see OroPocket’s mark. What white-label does not give you is a native app in the stores, push notifications under your name, an independent release train, or a themed interface beyond the assets above — the whitelabel reference is explicit about the boundaries.