Skip to main content

Add custom branding

GOV.UK Pay supports custom branding on your payment journey.

You can use custom branding regardless of whether you integrate your service with GOV.UK Pay, or use payment links.

Custom branding applies to the test and live environments for a service. You must tell us which service you want to apply custom branding to.

You can apply custom branding to your payment pages and your payment confirmation emails.

You cannot use different custom branding for payment pages and emails.

For the payment pages and emails, you can customise:

  • the logo displayed in the left-hand or right-hand side of the top banner
  • the background colour of the top banner

For payment pages only, you can also customise the border colour of the top banner.

To set up custom branding, do the following.

  1. Send us your customised banner logo and banner colours.
  2. Include contact information on your payment confirmation emails.

Send us your banner logo and banner colours

Send the GOV.UK Pay team:

  • an image of your banner logo
  • the colours of your banner background and border

To customise your banner logo, email us an image of your banner logo. Your image should be:

  • in PNG or SVG format
  • 300 pixels or less in height
  • 120 pixels or less in width
  • at least double the size of the image as displayed on-screen
  • cropped to leave minimal whitespace around the logo
  • compressed (optimised for web)

If you follow these requirements, your banner logo will look clear on both mobile and non-mobile displays.

Customise your banner colours

For payment pages, you can customise both the background and border colours of the top banner.

For payment confirmation emails, you can only customise the background colour of the top banner.

To customise these features, email us your hexadecimal colour codes.

Include contact information on your payment emails

When you have custom branding on your payment confirmation emails, those emails must tell your users how to contact you.

You can include this information on your emails by using, for example, a reply-to email address or a contact form.

If you use a reply-to email address, this email address can be a monitored email inbox for your service, or an unmonitored email address with an automated response.

If you use an unmonitored automated email response, you should tell your users:

  • that the email address is unmonitored
  • how they can contact your service

You can customise your email responses in the GOV.UK Pay admin tool using the customParagraph field in the payment receipt email template.

You cannot customise your refund email.