Keycloak: Design your theme visually with Quick Theme

This documentation is part of the Customise the appearance guide. You can view the complete guide here: Easily brand your Keycloak login pages, account console, and emails on Stackhero: set your colours, logo, texts, and even create fully custom themes using the built-in online editor..

👋 Welcome to the Stackhero documentation!

Stackhero offers a Keycloak cloud service that makes it easy 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 integrated HTTPS for secure access (for example, https://login.your-company.com)
• Custom themes: easily brand your login pages, account console, and emails with the included online editor
• Dedicated email server with SPF, DKIM, and DMARC, so account confirmations and password resets are managed for you
• Built-in PostgreSQL database, with the administration console accessible on its own dedicated, closable port
• One-click updates keep your system up to date without manual intervention

Spend your time developing, not configuring: you can try Stackhero's Keycloak cloud solution in under 5 minutes.

In your Keycloak administration console, you will find Quick Theme, Keycloak's visual theme designer. Upload a logo, choose your colours, preview your login and account pages, 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 wish.

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 will be installed as acme-1, ensuring your uploads never overwrite your work. If the file is not a theme, it is simply ignored and Keycloak starts as usual.