Skip to main content
For a more seamless user experience you can heavily customize the pre-built UI branding by providing your own theme. Visit the branding tab in the Authsignal Portal to get started. If you require a more bespoke branding experience then try out our UI customization tool. This tool allows you to change a wide range of design tokens (colors, borders, alignment, text) to tweak the look and feel of the entire pre-built UI.

The advanced customization tool provides a preview of various pre-built UI screens.

​
Custom templates

To override the pre-built UI’s layout you can provide a custom template. Custom templates, at a bare minimum, must contain the following structure. 
<html>
	<head>
		<authsignal-head></authsignal-head>
	</head>
	<body>
		<authsignal-widget></authsignal-widget>
	</body>
</html>
The authsignal-head and authsignal-widget tags are required for the pre-built UI to function correctly.
To update your tenant’s custom template, you can send the following payload to the Update Theme endpoint. 
{
  "template": "<html><head><authsignal-head><\/authsignal-head><\/head><body><authsignal-widget><\/authsignal-widget><\/body><\/html>"
}
The template string must have escaped special characters.

​
Adding custom HTML/CSS

Using a custom template allows you to add your own HTML/CSS. For example, if you wanted to show an image next to the pre-built UI you could use the following template: 
<html>
	<head>
		<authsignal-head></authsignal-head>
		<style>
			.wrapper {
				display: grid;
				grid-template-columns: 1fr 1fr;
			}
			.image {
				display: block;
				width: 100%;
				height: 100%;
				z-index: 10;
				background-size: cover;
				background-position: center;
				background-repeat: no-repeat;
				background-image: url(https:\/\/images.unsplash.com\/photo-1682685795579-37e731bfefab?q=80&w=1374&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDF8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D);
			}
		</style>
	</head>
	<body>
		<div class="wrapper">
			<authsignal-widget></authsignal-widget>
			<div class="image"></div>
		</div>
	</body>
</html>
Which would result in:

​
Adding custom JavaScript

To add custom JavaScript to your custom template you can use the following structure: 
<html>
	<head>
		<authsignal-head></authsignal-head>
		<script src="https://cdn.some-javascript.min.js"></script>
	</head>
	<body>
		<authsignal-widget></authsignal-widget>
	</body>
</html>
⌘I