Skip to content

Add overridable login header, aside, alert, and language macros - #55265

Draft
edewit wants to merge 1 commit into
keycloak:mainfrom
edewit:feat/login-theme-chrome-hooks
Draft

edewit wants to merge 1 commit into
keycloak:mainfrom
edewit:feat/login-theme-chrome-hooks

Conversation

@edewit

@edewit edewit commented Nov 17, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Extract login chrome into overridable Base macros: header.ftl, aside.ftl, alert.ftl, and language-selector.ftl, alongside the existing footer.ftl hook, so custom themes can change brand content, side marketing/help text, alerts, and the locale selector without replacing template.ftl.
  • Keep the default aside empty; when a custom theme provides aside content, keycloak.v3 switches to a two-column layout on wide viewports.
  • Document the hooks in the UI customization guide, upgrading notes, and release notes.

Let custom themes customize brand content, a side marketing panel, alerts, and the locale selector without replacing template.ftl, matching the existing footer.ftl hook.

Signed-off-by: Erik Jan de Wit <erikjan.dewit@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant