Skip to content

Add custom branding to confirmation emails - #2285

Merged
theseanything merged 3 commits into
mainfrom
custom-branding-for-confirmation-emails
Aug 13, 2026
Merged

Add custom branding to confirmation emails#2285
theseanything merged 3 commits into
mainfrom
custom-branding-for-confirmation-emails

Conversation

@theseanything

@theseanything theseanything commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Forms with a configured brand now send confirmation emails with the organisation's logo, colours and website link in the banner instead of GOV.UK branding, matching the branded web pages. This applies to both variants, including emails with a copy of the user's answers.

Only the confirmation emails, not submission emails to form processors. They keep the GOV.UK banner, and forms with no brand or an unrecognised brand ID fall back to it too.

Email clients need absolute image URLs, so there's a new forms_runner.base_url setting for this app's public URL.

Added here:
govuk-forms/forms-deploy#2239

image

@theseanything
theseanything force-pushed the custom-branding-for-confirmation-emails branch 2 times, most recently from 9ee3b9b to 6d8ebb8 Compare August 12, 2026 10:17
@theseanything
theseanything marked this pull request as ready for review August 12, 2026 10:27
Move the banner markup from the mailer layout into a partial
unchanged, so a custom branded banner can be swapped in for
confirmation emails without touching the other mailers.
Emails need absolute URLs for branding assets, which are served
from the public directory using relative paths. Deployed
environments must set SETTINGS__FORMS_RUNNER__BASE_URL. The
setting name matches the base_url settings for the other apps.
Forms with a configured brand now send confirmation emails with
the organisation's logo, colours and website link in the banner
instead of GOV.UK branding, matching the branded web pages. The
mailer opts in by setting @Branding, so emails to form
processors keep the GOV.UK banner even for branded forms.
@theseanything
theseanything force-pushed the custom-branding-for-confirmation-emails branch from 6d8ebb8 to b3819df Compare August 12, 2026 10:27
@github-actions

Copy link
Copy Markdown
Contributor

🎉 A review copy of this PR has been deployed! It is made of up two components

  1. A review copy of forms-runner
  2. A production copy of forms-admin

It may take 5 minutes or so for the application to be fully deployed and working. If it still isn't ready
after 5 minutes, there may be something wrong with the ECS task. You will need to go to the integration AWS account
to debug, or otherwise ask an infrastructure person.

For the sign in details and more information, see the review apps wiki page.

@stephencdaly stephencdaly left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The changes look sensible. Have you tested this in all the different Outlook versions? https://github.com/govuk-forms/forms-team/wiki/Testing-submission-email-changes

@theseanything

theseanything commented Aug 13, 2026

Copy link
Copy Markdown
Contributor Author

The changes look sensible. Have you tested this in all the different Outlook versions? https://github.com/govuk-forms/forms-team/wiki/Testing-submission-email-changes

I've tested it on Outlook online. I'll will go ahead an merge this, and fix forward if it breaks other clients - as the feature is not being used in prod atm

@theseanything
theseanything added this pull request to the merge queue Aug 13, 2026
Merged via the queue into main with commit a1aae99 Aug 13, 2026
3 checks passed
@theseanything
theseanything deleted the custom-branding-for-confirmation-emails branch August 13, 2026 09:52
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.

2 participants