.css, .sass or .less

Let's see, as an example, the different ways you have to change the backgrouns image of the login page.

First let's download a background image an put it in our public directory:

If you wish to do so, you can hot swipe assets that you have placed into your public directory in your Keycloak instance files at:

/opt/keycloak/themes/<name of your theme>/<login|account>/resources/dist

Let's apply this image to the body using plain CSS

body.kcBodyClass {
    background: url(/background.png) no-repeat center center fixed;

We import the StyleSheet:

import "./main.css";
import { Suspense, lazy } from "react";
// ...

Result (see testing your theme):

If you prefer, you can also move the background.png image from public/ to, for examples, src/login/assets/background.png and reference the image with a path relative to the CSS file, in this case it would be:

body.kcBodyClass {
    background: url(./assets/background.png) no-repeat center center fixed;

Now let's see how we would apply a different background image for different pages of our theme.

Last updated