Keycloak: Design your theme visually with Quick Theme

This documentation is part of the Customize the appearance guide. View the full guide here: Easily brand your Keycloak login pages, account console, and emails on Stackhero: set your colors, logo, texts, and even create full custom themes using the built-in online editor..

👋 Welcome to the Stackhero documentation!

Stackhero provides a Keycloak cloud service that makes it simple to deploy a production-ready identity provider in just 2 minutes:

• Unlimited users, realms, and clients
• Supports OpenID Connect, OAuth 2.0, SAML 2.0, social login, LDAP, and Active Directory federation
• Custom domain name with built-in HTTPS for secure access (for example, https://login.your-company.com)
• Custom themes: easily brand your login pages, account console, and emails with an included online editor
• Dedicated email server with SPF, DKIM, and DMARC, so account confirmations and password resets are handled for you
• Built-in PostgreSQL database, with the administration console available on its own closable port
• One-click updates keep your system current without manual intervention

Spend your time building, not configuring: you can try out Stackhero's Keycloak cloud solution in as little as 5 minutes.

In your Keycloak administration console, you will find Quick Theme, Keycloak's visual theme designer. Upload a logo, pick your colors, preview your login and account consoles, and download the finished theme as a .jar file.

To install it, place the file in the themes/ directory using the editor, then restart your service. The .jar is unpacked into a theme directory and the archive is removed:

themes/acme.jar        becomes     themes/acme/

The new theme will appear in Realm settings > Themes. You can continue editing its files manually if you choose.

This method also supports themes built with Keycloakify or themes provided by a designer. Any .jar or .zip containing a theme can be installed this way. If there is already a theme with the same name, the new one is installed as acme-1, ensuring uploads never overwrite your work. If the file is not a theme, it is simply left untouched and Keycloak starts as usual.