How to set up your organization's brand in POK
Your brand is the POK setting where your organization uploads its logo, banner, colors, header and footer once. Every new branding customization then starts from those values instead of POK's: custom credential pages, email brands, the recipients' wallet, the wallet pass and the acceptance page. You can also apply your brand to the customizations you already have, in one step.
Your brand is a premium feature, enabled per organization. To turn it on, talk to your account executive or write to contact@pok.tech. Without it, the "Your brand" tab explains the feature instead of showing the editor, and every customization keeps starting from POK's defaults.
How do I open Your brand?
Your brand is a tab in your organization settings, and you can reach it from two places.
From Branding:
- Open "Branding" from the main menu.
- Click "Customize" on the first card, "Set up your brand".
From Organization Settings:
- In the top navigation bar, click your organization's name, then click "Organization Settings".
- Open the "Your brand" tab, next to "Organization verifications", "Preferences" and "Connected accounts".
What can I set in Your brand?
Your brand has five sections: Logo, Banner, Brand colors, Header and Footer. The tab opens on "Upload your organization's brand", and each section has its own "Reset" button at its bottom left. That button resets only its section: Logo and Banner are emptied, and the other sections go back to POK's values.
- Logo. A "Main logo" and, optionally, a "Secondary logo": upload the secondary one if you want a different version in the header and footer. Drag the file onto "Drop your logo" or click it to browse your files. Both accept PNG or JPG files up to 2 MB; SVG is not accepted.
- Banner. A full-width banner image, PNG or JPG, with a recommended size of 1440 × 160 px or 2880 × 320 px (9:1 ratio). Its "Background color" "Shows behind the banner when the image doesn't cover the full width."
- Brand colors. "Buttons and elements" is applied to buttons, links and highlighted elements; "Button text" changes the text color of buttons.
- Header. "Header color" and "Header text color". While you have a secondary logo, a "Use secondary logo" checkbox lets the header show it instead of the main one.
- Footer. Choose between "POK footer" and "Create my own":
- "POK footer" keeps POK's standard footer, with the platform's logo and links. There is nothing to set up.
- "Create my own" gives you a "Footer color", a "Footer text color", "Use secondary logo" (while you have one), a "Brand slogan" and "Columns and links".
How do I add links to my footer?
A custom footer holds up to three columns of up to five links each. In "Columns and links", click "Add links" to open "Footer links", add columns with "+ Add column", give each a "Column title", and add links with "+ Add link". The "Footer preview" next to them updates as you type.
- Every link has a "Link text" and an optional URL. A link without a URL is shown as plain text.
- If the link text is an email address and you leave the URL empty, clicking it opens a new email to that address.
- You can type the URL without the protocol: www.example.com is saved as https://www.example.com. An address that starts with http:// is refused, because it must be https://.
Click "Save links" to keep them in the brand, then save the brand itself.
What does the contrast warning mean?
The contrast warning means a text color is hard to read on its background, for example the header text on the header color. The section shows "The text doesn't contrast enough with the chosen background. Adjust either of them so it reads well." The check follows the WCAG AA contrast level. It is only a warning: you can still save.
How do I save or reset my brand?
Click "Save changes". After saving you see "Your brand was saved. New branding customizations will start from these values." The button stays disabled until something differs from what is saved, or until you tick "Also apply it to what you already customized" on a brand you already saved.
The "Reset" button next to "Save changes" resets the whole brand at once: no logos or banner, POK's colors and POK's footer. Like any other change, it only takes effect when you save.
If you try to leave the tab with unsaved changes, POK stops you and asks you to close the message with "Cancel" and click "Save" first.
What changes when I save my brand?
Nothing your recipients see changes when you save your brand. Your brand is the starting point of each new customization, and the value each editor's own "Reset" goes back to:
- The first time you customize the recipients' wallet, the wallet pass or the acceptance page.
- Each new custom page you create.
- Each new email brand you create.
Customizations you already saved keep their own values until you apply your brand to them. A page you copy and an email brand you duplicate keep the values of the one they came from. Without a saved brand, or without the feature enabled, everything starts from POK's defaults.
Which values of my brand reach each customization?
| Customization | Values that come from Your brand |
|---|---|
| Recipient wallet | Header logo (the main logo, or the secondary one if the header uses it), header color, banner image and background, and "Buttons and elements" as the primary color and the tab color |
| Wallet pass | Main logo, on Apple Wallet and Google Wallet, and "Buttons and elements" as the label color |
| Acceptance page | Main logo, the banner's "Background color" as the page background, "Buttons and elements" as the brand color and the button color, and "Button text" |
| Custom pages | Header logo, header color, banner image and background, "Buttons and elements" as the primary color, "Button text", and the whole footer: the choice between POK's and your own, its colors, slogan, links and logo |
| Email brands | Header logo, header color, banner image and background, "Buttons and elements" as the button color, and "Button text" |
The header color only carries over once you change it from the white Your brand starts with. Your issuer public profile is not affected by Your brand.
What happens if my brand has no logo?
A customization that takes its logo from a brand without one shows no logo at all: not POK's, and not your organization's name. That holds for custom pages, the recipients' wallet (in POK and in the public list of their credentials), the acceptance page and emails. Only a screen you never customized shows POK's logo.
The wallet pass is the exception: a pass always needs a logo, so without one it shows POK's.
How do I apply my brand to pages, emails and wallets I already customized?
Tick "Also apply it to what you already customized", next to "Save changes", and save. POK then overwrites the logo, colors, banner and footer of the customizations you choose with your brand's values.
Saving opens "Apply your brand to what you already customized?". Under "Choose where to overwrite your brand's values" you pick the customizations to update, all of them ticked to begin with: "Custom pages", "Email brands", "Recipients' wallet", "Wallet pass" and "Acceptance page". The dialog reminds you that "Only the logo, colors, banner and footer change. Texts, ads and widgets stay as they are.", and warns:
This can't be undone: the previous values of each customization are lost.
Click "Apply and save". If you untick every customization, the button just saves your brand, and stays disabled when there is nothing new to save.
You do not need to change anything to apply a brand you saved earlier: tick the checkbox and save again.
What happens to images when I apply my brand?
Images follow your brand exactly: if your brand has no logo or no banner, the customizations you apply it to lose theirs too. The banner of an email brand is the exception: an email brand keeps its own banner image when your brand has none. Its logo is not, so applying a brand without a logo removes the logo from your emails' header too. An email brand whose header or banner is switched off keeps it switched off.
When applying would leave some of the customizations you ticked without a logo, the dialog names them before you confirm, for example:
Your brand has no logo for: Custom pages, Email brands. Applying it removes the logo they have now.
Which logo each customization takes decides whether it is listed: custom pages, the recipients' wallet and email brands take the header's logo (the secondary one if the header uses it), and when your brand's footer is "Create my own", custom pages also take the footer's logo for their footer; the acceptance page takes the main logo. The wallet pass is never listed, because it falls back to POK's logo.
How long does applying my brand take?
Applying your brand runs in the background and can take a few minutes, so you can keep working. The tasks panel at the bottom of the screen shows "Applying your brand" followed by how many items it has gone through out of the total, for example "Applying your brand 12 of 40 elements". An item that fails to update is retried automatically before it counts as failed.
When it finishes, the panel shows "Your brand was applied" and one line per customization with how it went: "Updated" for the items that now carry your brand, "Skipped" for items that were deleted before their turn came, and "With errors" for items that still could not be updated after the retries. The result stays in the panel until you close it.
Why does a customization show errors after I applied my brand?
Some of its items could not be updated even after POK retried them. Apply your brand again: tick "Also apply it to what you already customized", save, and keep ticked only the customization that had errors. Items that were already updated are simply overwritten with the same values.
Why was my logo or banner refused?
Your brand only accepts PNG or JPG files up to 2 MB. Any other format, SVG included, shows "File type not supported. Use PNG, JPG, JPEG.", and a larger file shows "The file is larger than 2 MB." Convert or compress the image and upload it again.
Why didn't my existing pages change after I saved my brand?
Saving your brand only changes where new customizations start. To update the ones that already exist, tick "Also apply it to what you already customized" and save again.
Why doesn't the "Use secondary logo" option appear?
It only appears while there is a secondary logo. Upload one in the Logo section first.
If you have any questions or run into issues, contact us at contact@pok.tech.