How to customize keycloak Admin and Account theme for keycloak version 24.0.2?

We are aiming to customize the Keycloak Admin and Account themes for our internal applications. Unfortunately, the official documentation does not provide specific guidance on this topic. While the available information allows for the customization of static text displayed within the UI, our requirements extend to modifying the CSS to better align with our corporate branding and aesthetic preferences.

1 Like

The extending the server guide gives you a decent starting point. You can take any of the ftl template files and adjust them to fit your needs. My approach usually started with the themes in the source keycloak/themes/src/main/resources/theme at 24.0.3 · keycloak/keycloak · GitHub and then overriding the files as necessary in my own theme folder. Word of caution, always double check you select the tag of the version you want to deploy otherwise you’ll see the weirdest issues.

Otherwise there are projects like GitHub - keycloakify/keycloakify: 🔏 Create Keycloak themes using React, which can make things easier, but personally i have no experience with it yet.

The login theme (the current standard one and the upcoming (preview) v2 one) are both fairly straightforward to customize and override, although tedious to maintain. Just as a warning, consider this when customizing as it will increase the cost of future upgrades, as you’ll have to diff your custom theme with the upstream changes and adapt them accordingly and test it extensively. And you probably don’t want to end up like many people here, with a keycloak version that it many years old.

For the new account console (v3) my experience has been mixed, I’ve posted some ramblings about it on github Administrator experience of customizing account console v3 · keycloak/keycloak · Discussion #28393 · GitHub.
At least the examples how to extend it have been updated keycloak-quickstarts/extension/extend-account-console at release/24.0 · keycloak/keycloak-quickstarts · GitHub, so they might be worth a look.

Dumb question: Where do I find the original v3 theme files? They don’t seem to be included with lib/lib/main/org.keycloak.keycloak-themes-25.0.0.jar.

they got moved to a different maven module (js). There might be a dedicated jar for that. So far my workflow has been to just build that module myself and obtain the file from the target folder.

Hi, same issue here. Searching for the default template but can’t find it. Need this as example for modifications.
Anyone could help?

Thanks in advance.

Ok, are these the source files?
So the workflow is to build that module with pnpm run build, and then make your modifications to it’s target folder, did I get that right?

Depends on what you want to do, I just needed to add a few lines to the index.ftl so i just copy that one over so the old override mechanism continues to work.

Sorry, I’m not sure how to get the template.

What I actually want to do is just swap the logos and hide the applications.
Is there any smart way to do this?

Thank you so much

Hi all,

Is is possible to change logo, icon and favicon in keycloak 23.0.3 ?

As I tried to do the same but I am unable to do so as always there error saying:

  1. Refused to apply style from ‘http://localhost:8080/resources/dlzsz/admin/mytheme/css/styles.css’ because its MIME type (‘’) is not a supported stylesheet MIME type, and strict MIME checking is enabled.

  2. GET http://localhost:8080/resources/dlzsz/admin/mytheme/public/logo.svg 404 (Not Found)

I don’t understand from where it is taking this path “resources/dlzsz/”.

Any guidance would be appreciated.

Thanks & Regards
Shail M.

Overriding parts of your theme is possible and documented here: Server Developer Guide

Create a custom theme, add these to the resources, set the theme properties correctly and the automatic overrides will grab the files from your theme first.

Hi ThoreKr,

Thanks for the response. I already seen this documentation and it does not helped me to customize admin console specially I wanted to change the title favicon, logo and body icon.

This documentation focused on login customization mainly. and that is working fine.

please suggest me ways to customize admin console.

thanks.

1 Like