Skip to main content
pdf?stylesheet=default
Blackboard Help

Customizing the Login Page

Administrators can download login page templates supplied with Blackboard Learn and configure them for their system. If a login page template breaks, or is not appropriate for the institution, the default login page can be restored so that users can access the system with minimal interruption.

You can also manage different login pages and login names for different brand hosts. The ability to manage login names by brand host is available only if your institution licenses community engagement.

All the relevant styles for any custom login pages must be included within the <head> tags of the login page to render properly.

How to Manage the Login Page

  1. On the Administrator Panel, under Communities, click Brands and Themes.
  2. Click Customize Login Page. The following table describes the available tasks.
    Customize Login Page Available Tasks
    Operation Description
    Download a template for the login page Download Login Page Template. The template download will begin.
    Download the current customized login page Download Custom Login Page. The template download will begin. This operation downloads the current customized login page, if there is one. The current customized login page is either the default login page or a custom login page.
    Upload a customized login page Upload Custom Login Page. The Upload Custom Login page appears. From this page, the path to a customized login page is entered. The customized login page is then uploaded and set as the login page
    Reset the login page to the default Reset to Default Login Page. The login page will be set to the default.

How to Customize the Login Page

  1. On the Administrator Panel, under Communities, click Brands and Themes.
  2. Click Customize Login Page to download and customize a copy of the JSP login page.
  3. Click Download Login Page Template.
  4. A download window web browser will appear. Select Save File and click OK.
    If a download window does not appear, right-click Download Login Page Template and select Save Target As.
    The login file will be saved to the directory.
  5. Open the login file with a text editor. The colors, style of text, and the text itself can be edited. It is also possible to create a link to an image.
  6. Save the login file to your local machine or the Content Collection. To learn more, see Content Collection.
  7. Click Customize Login Page.
  8. Click Use Custom Page, and then select one of the following options:
    1. Click Browse My Computer to search for an existing JSP login page saved on your local system.
    2. Click Browse Content Collection (available only if your institution licenses content management) to search for a JSP login page within Content Collection.
  9. Click Preview to preview your login page. If everything looks good, click Submit.
  10. Logout to test the new login page.

    If the page fails and you are unable to log in, type the following address in your web browser to bring up the default login page: http://domain_name.host_name/webapps/login?action=default_login. After logging in, go back to Customize Login Page and click the link to restore the default login page. This will allow users to once again login.

How to Customize a Brand Login Page - Community License Only

  1. On the Administrator Panel, under Communities, click Brands and Themes.

  2. Click Manage Brands.
  3. If you have already created host name brands, search the list of brands for those that have the Everyone role selected. If you do not have any host name brands created, see Managing Brands to learn more about creating them. The role for the host name must be set to Everyone to customize a brand login page.
  4. Click the arrow next to the host name brand to display a pop-up menu.
  5. Click Login Page. This option is available only if you set the role for the host name to Everyone in step 3 above.
  6. Click Use Custom Page, and then select one of the following options:

    1. Click Browse My Computer to search for an existing JSP login page saved on your local system.
    2. Click Browse Content Collection (available only if your institution licenses content management) to search for a JSP login page within Content Collection. To learn more, see Content Collection.
  7. Click Preview to preview your login page. If everything looks good, click Submit.
  8. Logout and test the new login page.

    If the page fails and you are unable to log in, type the following address in your web browser to bring up the default login page: http://domain_name.host_name/webapps/login?action=default_login. After logging in, go back to Customize Login Page and click the link to restore the default login page. This will allow users to once again login.