Default Template when Using Page Templates

Knowledge Articles
,
1

Overview

This article explains why the following error occurs when attempting to retrieve the default Universal Login template using the api/v2/branding/templates/universal-login API endpoint:

Template does not exist.

Applies To

  • Page Templates

Cause

The error occurs because a default template does not technically exist. Configuring a page template changes how the Universal Login page is rendered, so there is no default version to retrieve via the API.

Solution

Configuring a page template can override some, but not all, no-code editor settings. For example, if both a background image URL and a background color are set, a configured page template displays the background color. Without a page template, the linked image is displayed instead. Due to these differences, a direct default template is not available.

Use the following template as a starting point for customization:

<!DOCTYPE html>
<html lang="{{locale}}">
  <head>
    {%- auth0:head -%}
  <title>{{ prompt.screen.texts.pageTitle }}</title>
  </head>
  <body class="_widget-auto-layout">
    {%- auth0:widget -%}
  </body>
</html>

NOTE: For more details on the customization options available in Page Templates, refer to Customize Templates.