Skip to content

Rewrite the verify-email message - #11

Merged
johardi merged 1 commit into
mainfrom
update-verify-email-message
Jul 17, 2026
Merged

Rewrite the verify-email message#11
johardi merged 1 commit into
mainfrom
update-verify-email-message

Conversation

@johardi

@johardi johardi commented Jul 17, 2026

Copy link
Copy Markdown
Member

What this changes

Updates the wording of the "verify your email" message people get when they register or need to confirm their email address, so it's clearer about why they're getting it and what to do.

The catch

The custom webprotege email theme already existed in this repo, but the realm was actually configured to use Keycloak's stock keycloak email theme instead (emailTheme in webprotege.json). So any wording changes made here previously would have had zero effect — nothing was ever reading the custom email theme. This fixes that too, so the new wording (and any future changes here) actually take effect.

Testing

Built the image locally, pointed a running realm at the theme, and sent a real verification email to a throwaway test account through Keycloak's admin API. Confirmed both the plain-text and HTML versions render the new copy correctly, with the link, app name, and expiry time all filling in as expected, then deleted the test account.

The webprotege email theme only overrode theme.properties (styles/parent),
so the realm's emailTheme was still set to the stock "keycloak" theme and
every email used Keycloak's default wording regardless of what lived under
webprotege/email.

Add a messages override with plain-language verify-email copy explaining
why the user got the email, what to do, and that it expires soon. Point
the realm at the webprotege email theme so it's actually used.
@johardi
johardi merged commit e5c2a9a into main Jul 17, 2026
2 checks passed
@johardi
johardi deleted the update-verify-email-message branch July 17, 2026 22:44
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