---
title: "Configuring Custom URL and Login Pages"
slug: "custom-url-and-login-pages"
updated: 2025-07-14T10:51:07Z
published: 2025-07-14T10:51:07Z
canonical: "documentation.encodify.com/custom-url-and-login-pages"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.encodify.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuring Custom URL and Login Pages

## Overview

---

A **Login URL** determines which login page is displayed to users when they navigate to a specific site address. It consists of two parts:

- **Site URL** – The base address users will navigate to.
- **Login Page** – The login interface that will be presented.

Each Login URL must be linked to an Identity Provider to enable user authentication within the Encodify platform.

> [!WARNING]
> **Note:** A Login URL must be configured for each Identity Provider to ensure users are routed to the correct login experience.

## Configuring a Login URL

---

### Adding a Login URL

To add a new Login URL:

1. Click **Add New Login URL**.
2. Enter the **Base Site URL**. *(This is typically pre-filled based on the current site settings.)*
3. Select the **Login Page** to be used.
4. Click **Save**.

## Configuring a user-defined Login Page

---

Login Pages define the design and behaviour of the login interface shown to users when they access an Encodify site. You can create custom login pages using HTML and CSS, control their appearance, preview them, and assign them to specific sites.

> [!WARNING]
> **Note:** Custom login pages can only be applied after a Login URL has been created and assigned to a site.

### Creating a Login Page

To create a custom login page:

1. Navigate to **Site Configuration > Identity Providers and Users > Login Pages**.
2. Click **Add New Login Page**.
3. Complete the following fields:

| **Field** | **Default Value** | **Description** |
| --- | --- | --- |
| **Login Page Name** | *My New Login Page* | Name of your custom login page. |
| **Enable “New User Request”** | Enabled | Adds a link for users to request access from the login page. |
| **Background Colour** | `#f9f9f9` | Background area between the top bar and the footer. |
| **Top Bar Colour** | `#081b26` | Colour of the top navigation bar. |
| **Highlight Colour** | `#3c8dbc` | Colour for hovered links and buttons. |
| **Footer Color** | `#f9f9f9` | Footer background colour. |
| **Footer Text Color** | `#999999` | Colour of footer text. |
| **Footer Logo with Black Text** | Enabled | Displays the Encodify footer logo in black. Unchecked = white. |
| **Welcome Text** | *Welcome, please log in* | Displayed above the login form. |
| **Top Bar Logo** | *Standard Encodify Logo* | Upload a company logo (max height: 90px). Supported formats: `.gif`, `.jpg`, `.png`. |

1. **(Optional)**Add **Custom CSS**, allowing you to redefine styles for login page elements.
2. **(Optional)** Add **Custom HTML,** allowing you to insert elements that render below the "Forgot Password" link.
3. **Click** **Preview Login Page** to see how the login page will appear.
4. **Click** **Save** to create the login page.

> [!WARNING]
> **Note:** If you want to render external resources on login page such as images, video, JS applications etc., place all resources you need in `<EncodeWebApplicationFolder>/css/custom/common/` folder and link to them as following, for example:
> 
> `<img src="https://qa.test.com/qa/css/custom/common"></img>`

### Managing Login Pages

On the **Login Pages** screen, you can:

- **Preview:** Click the ellipsis next to a login page and select **Preview**.
- **Edit:** Click **Edit**, update the fields or design, and click **Save**.
- **Delete:** Select **Delete** from the ellipsis menu to remove a login page.

### Assigning Login Pages to Sites

Login pages are site-specific. To assign a login page to a site:

1. Go to **System Configuration > Site List**.
2. Click the **Edit** icon for the desired site.
3. Open the **Appearance** tab.
4. From the **Login Page** dropdown, select the page to assign.
5. Click **OK** to save.

Once assigned, logging out and revisiting the site will load the selected login page.

User-defined login pages can also be accessed directly via URL. For example:

In the URL`http://qa.test.com/qa/common/login/ebms?LoginPage=user_defined_5`, the `?LoginPage` parameter specifies which login page to use. You can select the desired login page by adding `?LoginPage=user_defined_{id}` to the URL, where `{id}` corresponds to the login page’s identifier.

To set a user-defined login page as the default, specify it in the `System.properties` file. The default login page will be used for any sites that do not have a specific login page configured or are set to use the default. To do this, add the following line to your `System.properties` file:

```plaintext
iniCopyEditloginPage=user_defined_{id}
```

---

### Setting a Default Login Page

To use a specific login page as the default (for all sites that don’t have one assigned):

1. Open the `System.properties` file.
2. Add the following entry:

```plaintext
propertiesCopyEditloginPage=user_defined_{id}
```

1. Restart the application server for the changes to take effect.

### Enabling Access Requests for New Users

Users without an account can request access from the login page if the feature is enabled.

To enable:

1. In the login page editor, make sure the **Enable “New User Request”** option is checked.
2. Add the following properties to your `System.properties` file:

```plaintext
propertiesCopyEditnew.user.request.mailto=admin@example.com
new.user.request.subject=New User Access Request
new.user.request.templateFile=../properties/common/new_user_request.template
```

- `mailto` – Required. A comma-separated list of email recipients.
- `subject` – Optional. Subject line for the email (default used if omitted).
- `templateFile` – Optional. File path for the email body template. Default template is used if not specified.

1. Restart the application server to apply changes.

#### To submit a request:

1. On the login page, click **New User Request**.
2. Fill in the required fields: **Full Name**, **Email Address**, and **Company**.
3. Click **Send Request**.

The request is emailed to the addresses specified in your `System.properties`.