Theme sets the palette, fonts, images, and favicons every member of the active organisation sees across the Console. The same logo, colours, and fonts style the PDF investor statements, and the Documents section sets the legal entity name, entity details, and disclaimer those statements print. Saving writes a new theme version with no separate publish step, and open Console tabs pick it up on their next navigation.
Theme changes nothing about which accounts can act for the organisation or what the organisation can transact. Those stay under “Roles and permissions” and “Networks”.
A section list on the left beside the settings in cards: “Branding”, “Sign-in page”, “Browser icons”, “Typography”, “Colours”, “Documents” and “Global theme”.
Each image shows its light and dark versions side by side, each with a “Replace” button. Colours has a “Light” and “Dark” switch and lists each colour by name with its id beneath.
Steps
Open Theme
Open “Organisation settings”, then Theme.
The “Theme sections” list on the left jumps to the sections in four groups:
- Identity holds “Branding”, “Sign-in page” and “Browser icons”.
- Appearance holds “Typography” and “Colours”.
- Statements holds “Documents”.
- Platform holds “Global theme”, for a platform administrator.
Change something and save
Change images, fonts or colours, or fill in “Documents”, as Change the images, Set typography, Change colours and Set the statement details describe. When something is unsaved, a bar at the foot of the page, “Unsaved theme changes”, counts the unsaved changes and offers “Discard” and “Save theme”.
Select Save theme to write the new theme version. While it saves, the bar reads “Saving…”. When “Save theme” is unavailable, the bar says why beside it: “An image is still uploading.”, “A colour value is invalid: <colour name>.” or “A stylesheet URL is invalid: <font>.”
Change the images
The “Branding”, “Sign-in page” and “Browser icons” sections hold these image slots:
- Logo: “Shown in the sidebar and on documents.”
- Logo icon: “Square mark for compact places.”
- Background image: the Console gives it no description line.
- Sign-in logo: “Uses the logo when left empty.”
- Overlay: “Shown behind the form at reduced opacity.”
- Favicon: a browser icon
- Apple touch icon: a browser icon
- Favicon 96: a browser icon
- Favicon SVG: a browser icon
Each image shows its light and dark versions side by side. Select Upload, or “Replace” when one is set, on the version you want to change. Screen readers announce the default SettleMint logo as “SettleMint”. Once you upload a logo of your own, they announce it by the logo's alternative text.
Set typography
Typography sets the “Sans-serif” face (“Used for most of the interface.”) and the “Monospace” face (“Used for addresses, code and figures.”). The sans-serif face sets words. The monospace face sets figures, such as amounts, prices, percentages and dates, also where a figure sits inside a sentence, and identifiers such as addresses.
For each face, choose the Source:
- Default keeps the faces the Console serves from its own origin, so a deployment without a route to the internet renders them.
- Custom CSS URL names a stylesheet you host, which adds a brand face without the Console requesting another host. Enter its “Stylesheet URL” and the “Family”.
With a custom URL, the browser requests that one stylesheet, and the Content Security Policy of the Console refuses a stylesheet on a different origin, so it must be served from the Console's own origin. Ask the platform operator who runs the deployment to host it there. The address must be https:// on a public host name such as cdn.example.com: the field says “Use an https:// address. Plain http, data: and javascript: addresses are not loaded.”, “Use a public host name, for example cdn.example.com. IP addresses and internal names are not loaded.” and “Use an address of at most 2048 characters.” The Console and the v1 and v2 theme writes refuse an IP address, a name with no dot such as localhost, and a name ending in .local, .localhost, .internal, .localdomain or .home.arpa. This keeps a theme from sending a visitor's browser to an address on a private network.
Three more settings apply to each face:
- Weights takes a comma-separated list (“Blank uses the defaults.”).
- Preload loads the font before the page renders.
- Sample previews the face.
Change colours
Colours has a “Light” and “Dark” switch, and lists each colour by name with its id beneath, grouped under “Text”, “Accent”, “Surfaces”, “Status”, “Charts” and “Other”.
Success, warning and info each have three colours named for what they paint: “Success background” is the fill of a badge or button, “Text on success background” is the colour drawn on that fill, and “Success text” is the state colour used for text on the page. Error has the first two. In the default theme the text on a success, warning or info fill is near-black in both sets, so its swatch reads dark beside the coloured swatch of its background. That pair is the default and does not mean a value was lost.
Select Edit <colour> colour to open the editor, where a value is a hex, oklch, hsl, rgb or var colour. An invalid value reads “Enter a valid colour (hex, oklch, hsl, rgb, or var).” and blocks the save.
Revert puts a colour back to its saved value.
Set the statement details
The Documents section sets what the PDF investor statements print: “Legal entity name”, “Entity details” and “Disclaimer”.
- Legal entity name prints as the issuer. When it is empty, the logo's alternative text prints.
- Entity details hold the address, licence and contact details, each on its own line.
- Disclaimer prints under Important information. Blank lines start a new paragraph, and the standard disclaimer prints when it is empty.
Reset the theme
To return to the platform default theme, open the “Actions” menu on this page, choose Reset to defaults, and confirm in the dialog “Reset the theme to defaults?” by selecting “Reset theme”, or “Keep my theme” to cancel. Reset saves the default theme at once and the Console confirms “Default theme restored”. It does not wait for “Save theme”, and it discards the logo and every other image along with the palette.
Turn on the global theme
A platform administrator also sees “Global theme”. Turn on makes the saved theme of this organisation the theme of every organisation, at once and without a question. The card reads “Used for every organisation” while it is on and “Not global” while it is off. While it is on, owners cannot change their own theme.
The Reason for the global theme change (optional) field on the card is recorded in the audit trail with “Turn on” or “Turn off”.
After “Turn on” or “Turn off”, a toast offers Undo for 8 seconds, which gives the global theme back to whoever held it before. Unsaved changes are not included.
Turn off applies at once.
Troubleshooting
Theme editing is disabled
The page shows “Theme editing disabled” and names the organisation whose global theme is active. While a global theme is on, no owner can change this organisation's theme, and the notice replaces the whole editor, “Global theme” included. A platform administrator opens the Organisation submenu of the account menu, switches to the organisation the notice names, and turns the global theme off under “Global theme” there. This organisation then uses its own saved theme again. If you are not a platform administrator, ask one to turn the global theme off.
An image upload fails
Check the file against the slot: SVG, PNG, JPEG or WebP for images, and for browser icons ICO, PNG or SVG in “Favicon”, PNG only in “Apple touch icon” and “Favicon 96”, SVG only in “Favicon SVG”, and at most 5 MB. An upload link expires after 15 minutes, so a slow upload needs a fresh attempt. Save theme stays disabled while an image is still uploading.
A palette value is rejected
Correct the invalid colour value shown by the editor, then save again. The editor blocks the save until every colour parses.
Save theme stays disabled
The bar says why in words beside the button: “An image is still uploading.”, “A colour value is invalid:” followed by
the colour name, or “A stylesheet URL is invalid:” followed by the font. Wait for uploads to finish, correct the named
colour, or give the font's custom stylesheet an https:// address on a public host name. The Console never loads a
plain http://, data: or javascript: stylesheet, or one on an IP address or an internal name. A theme saved with
such an address before this rule still opens, but that stylesheet is not loaded.
Unsaved changes from an earlier visit are offered after a reload
Unsaved changes stay in this browser, per user and per organisation, so a reload does not lose in-progress work. A draft does not follow you to another browser. The editor does not apply a kept draft on load: select Restore changes to continue it or “Discard changes” to clear it. A draft is discarded when it was made against an older saved version or introduces an invalid stylesheet URL. A draft with an invalid colour is offered like any other, but its colour is never applied, the field names it, and Save stays blocked until you correct it. A draft belongs to one organisation, so switching organisations does not carry it over.
Saving fails with a version conflict
Another save landed on this theme after you opened the editor, often from a second owner or platform administrator editing it around the same time. Note your changes, then reload Theme to load the latest saved version. A draft made against the older version is discarded on reload, so reapply your changes on top of the newer save.