New: the AI firewall watches the whole platform and explains each incident in plain words. See how it works

Give your organisation its own look, step by step

An ordered walkthrough for branding your organisation: logos and colours, the sign-in page, your own domain with its certificate, the mail sender, and what your members and customers then see.

This page is for owners and administrators who want Hermetry to look like their own application to their members and customers. It puts the steps in order and says what each one changes. The fields themselves are explained in Branding and Web addresses and custom domains; this page links there instead of repeating them.

Everything here is done inside your own organisation, by its own owners and administrators.

Before you start

You needWhy
The Admin roleTo change branding and the mail sender, and to verify a domain
The Owner roleTo add or delete a custom domain, make a domain primary, and reset all branding at once
A plan that includes custom domainsOnly for step 2. The Domains page says “Your plan includes up to n custom domains.” when it does.
Access to your DNS providerTo prove you own the domain and point it to Hermetry
Your images, ready as PNG, JPEG, GIF, WebP, AVIF or ICOSVG is not accepted. Sizes are in the table in step 1.
A sender address of your ownFor step 4, for example alerts@example.com

Step 1: brand the app and the sign-in page

Open Branding (Settings > Branding). The page has three cards.

  1. In Visual Identity, upload the images and pick the two colours. An uploaded image is saved at once (“Logo (light theme) saved.”); colours are saved with Save Branding.
  2. In Brand Info, enter the Brand Name and the Tagline. Left empty, the organisation’s own name is shown.
  3. In Sign-in page, upload a Sign-in wallpaper and enter a Privacy policy address and a Terms of service address. They appear under the sign-in card. Left empty, no link is shown.
  4. Select Save Branding. The page says “Branding saved.”
FieldPrepare
Logo (light theme)A horizontal logo, 48 px tall, at most 192 px wide
Logo (dark theme)The same on a dark background. Without it the light logo is used.
App icon (light theme)A square image, shown at 28 px in the header. Without it the favicon is used.
App icon (dark theme)Without it the light icon is used
FaviconA square PNG or ICO image, 32 × 32 px or larger
Sign-in wallpaperA wide photo or pattern, 1920 px wide or more
Primary Color, Secondary ColorHex colours such as #1a2b3c
Privacy policy and terms addressesAn address that starts with https://, or with a single / for a page on the same site

Watch the notes under each colour. Hermetry warns when text on buttons in the colour is hard to read (below 4.5:1) or when links in it are hard to see on a white page (below 3:1), and tells you when buttons use a slightly darker shade so their text stays readable. To go back to the default for one colour, choose No color in the colour picker and save. To remove an image, select Remove and save.

A field you leave empty uses the platform look. Fields and tips are in Branding.

Step 2: connect your own domain

Every organisation keeps its free address, <slug>.<platform domain>. It always works and cannot be removed, so it stays your way back in whatever happens to a custom domain.

  1. Open Domains (Settings > Domains) and select Add Domain. Use a subdomain such as iot.example.com. Adding a domain needs the Owner role.
  2. At your DNS provider, create the two records the page shows: the CNAME that points your domain to Hermetry, and the DNS Challenge Record that proves you own it.
  3. Open the domain and select Verify DNS. On success the page says “Domain verified successfully.” DNS changes can take up to 48 hours to reach everyone; if verification fails, wait and verify again.
  4. Wait a few minutes, then select Force SSL check. You never upload a certificate: Hermetry obtains one for the verified domain and renews it itself. The domain serves once a check sees its certificate working.

The records, the statuses and the certificate card are explained in Web addresses and custom domains.

Step 3: make your domain the primary

The primary domain is the address Hermetry uses in links it builds for your organisation, for example in notification mail. Your free address is primary until you change it.

  1. Open the domain and select Make primary. It is offered only for a verified domain whose certificate is in place.
  2. Confirm Make this the primary domain? (“Links and e-mails will use iot.example.com.”).

Making a domain primary needs the Owner role. While the primary domain does not serve, for example because the plan no longer includes it, links use your free address instead, so a link always lands on an address that works. If you delete the primary domain, your free address becomes primary again.

Step 4: set the mail sender

Open Email (Settings > Email). In Sender Identity, enter a From Name and a From Email and save. The From Name is used only together with a From Email; without a From Email, mail goes out from the platform’s sender.

If the page also shows SMTP Configuration, your organisation may send through its own mail server; fill it in with your provider’s details. If it does not, mail goes out through the platform’s mail service.

You do not edit the mail templates. Every mail Hermetry sends for your organisation is filled with your brand: the brand name, the logo, and the primary colour on its buttons. Mail never carries the favicon, the wallpaper or the legal links. Delivery, quotas and spam advice are in Email.

Note

Account and security mail (sign-in codes, password resets, e-mail verification, invitations) shows your brand but is always sent from the platform’s own sender, and its links open on the platform’s main address, not on your domain.

Step 5: check what people see

Open a private browser window and go through what a member or customer sees.

WhereWhat they see
The sign-in and sign-up pages at your free address or custom domainYour logo, brand name, colours and wallpaper, the privacy and terms links under the card
The browser tabYour favicon
The app after sign-inYour app icon in the header, your brand name, your colours on buttons, links, highlights and charts, in both light and dark theme
Notification mailYour brand name, logo and button colour, your sender identity, links on your primary domain
Account and security mailYour brand name, logo and button colour, the platform’s sender, links on the platform’s main address

Members who belong to several organisations and sign in on the platform’s main address pick the organisation after signing in. To land them on your branded sign-in page directly, share your custom domain or your free address.

If something does not look right

Message or symptomCauseFix
“Choose a PNG, JPEG, GIF, WebP, AVIF or ICO image. SVG is not accepted.”The image is an SVG or another typeExport it as PNG or WebP
“The image is too large.”The file is over the upload limitMake the file smaller
“… is locked by the platform operator and cannot be changed here.”The platform operator fixed this fieldLeave it; the other fields still save
“Someone changed the branding after you opened this page. Your changes are still here; reload to see theirs.”Another administrator saved in the meantimeCopy your changes, reload, and apply them again
Dark text on a dark headerNo dark-theme logo or iconUpload Logo (dark theme) and App icon (dark theme)
“Verification failed. Check your DNS settings.”The challenge record is missing or not visible yetCheck the record at your DNS provider and verify again later
Make primary is not offeredThe domain is not verified, or its certificate is not in place yetFinish step 2, then select Force SSL check
Your domain shows Paused (not in plan)The plan no longer includes the domainYour free address keeps working; the domain comes back when the plan includes it again
Mail still shows the platform’s senderNo From Email is set, or it is account and security mailSet a From Email in step 4; security mail always uses the platform’s sender

To start again from the platform look, an Owner selects Reset to defaults on the Branding page and confirms Reset branding. It clears every branding field: logos, icons, favicon, colours, wallpaper, name, tagline and legal links.