Customize portal and login windows

This topic describes how to customize the look and feel of your User Portal, the Admin Portal, and login windows.

Click Reset to restore the default settings for most options.
Customizations may not display with the initial user log in. Users may need to re-log in to see the changes reflected.

Edit portal and login window customization options

You can customize many elements of your portals and login windows, including color schemes, background images, error messages, the login experience, and more.

Step 1: Edit General Options.

  1. Log in to the Admin Portal.

  2. Go to Settings > Customization > Account Customization.

  3. Edit the fields under General Options.

    Field Description

    Portal Ribbon Accent Color

    Enter the hexadecimal color code for Portal Ribbon Accent Color to change the ribbon color. Do not enter the RGB value.

    Portal Ribbon Color

    Enter the hexadecimal color code for Portal Ribbon Color to change the ribbon color. Do not enter the RGB value.

    Company Name

    Company Support Link

    Enter information in Company Name and Company Support Link to create a link to your company support portal in the Admin Portal > Support menu (for more information on these settings, see Customize the support links).

    Portal Image

    Short Portal Image

    • Click Upload and browse to select an image file for the Portal Image and the Short Portal Image, then click Open.

      Once added, these images are located above the portal switcher in the left window pane. When you collapse the left pane, the short (smaller) portal image is displayed.

Step 2: Edit the fields under Login Customization, as described in the following table.

Field Description

User Name Hint Text at Login

Define the User Name hint text displayed to users on the sign in page. You can click Reset to reset this field to its default value of user@domain.

Login Image

Click Upload to browse to and select the image file for the Login Image, then click Open.

The login logo image must be at least 512 Bytes, no more than 1 MB, no larger than 1024x1024, and either .png, .jpg, .ico, .gif (non-animated), or .bmp.

Login Background Image

Click Upload to browse to and select the image file for the Login Background Image, then click Open.

The background image must have a file size between 512 Bytes and 5 MB, with dimensions of at least 700 x 490. Supported file types are .png, .jpg, .ico, .bmp, and .gif (non-animated).

Terms of Use

Enter the URL to your company Terms of Use.

Terms of Use will appear below the sign in area.

Privacy Policy

Enter the URL to your company Privacy Policy.

Privacy Policy will appear below the sign in area.

Step 3: Enable the new login experience

Click Turn on New Login Experience to enable the new CyberArk Identity Sign In screen (example screen shown below). This field is enabled by default.

Enabling this option means that users will see a Sign In screen similar to the following when they sign in to the CyberArk Identity the Admin Portal or User Portal.

Step 4: Customize the sign in error message.

Select Customize The Sign In Error Message, then replace the default message with a custom message.

A detailed error message helps deflect help desk tickets. Enter an error message to show to users who can't sign in due to one of the following reasons:

  • no challenges are defined

  • the user cannot answer an MFA challenge

  • the user's password has expired

  • the user's account is blocked

  • RADIUS server error

  • the user is using the wrong authentication factor for privileged access

Step 5: Hide CyberArk footer from login page

Click Hide CyberArk footer from login page to hide the copy right information, Terms of Use, and Privacy Policy from the login page. The image below shows the login page when the Hide CyberArk footer from login page check box is selected.

You can contact the CyberArk Support team if you want to hide Powered by CyberArk from the login page.

Step 6: Edit the fields under Message Customization (also see Customize email message contents for additional information).

Field Description

Use Custom Login Widget URL for the Invite Link

Click Use Custom Login Widget URL for the Invite Link to change the link in the new user invitation email to point to a login widget URL instead of the CyberArk Identity tenant URL. This assumes you have already set up a login widget that you want to use. Once enabled, enter the complete URL for the custom login widget in the provided text box (for example, https// When a new user is created with the Send email invite for User Portal setup option enabled, the email invitation is sent with the custom login widget link embedded in the email.

The URL must also be included in the Allowed Domain field in the Admin Portal > Settings > Authentication > Security Settings > API Security. See Authentication security options.

Email Image

Click Upload to browse to and select the image file for Email Image.

This is typically your company logo, and is only used for customized messages.

Step 7: Edit the default message templates as needed.

  1. Click the row associated with the template.

  2. Edit the Language, Email Subject, and Display Name, fields as needed.

  3. Click the Script Editor tab to modify the content of the message as needed.

    The message body can be found in the HTML on the script tab.

    In the Forgot User Name message template, you can change the message to drop the login suffix when the email is sent to a user by replacing the variable {UserList} with {UserLoginNameList}.

    Make the change on the Script Editor tab, then return to the Preview tab to verify the variable has changed. The result is the user receives an email with a list of usernames matching their email address that do not include the login suffix. This can prevent confusion for users when you use multiple login suffixes.

Reset portal and login customization options

You can quickly reset your customizations to default values by clicking the Reset buttons instead of manually changing settings.

  1. Click the Reset button associated with User Name Hint Text at Login to use the default hint text.

  2. Click the Reset button at the bottom of the page to use the default settings for all the customization options on this page.

  3. Click the Reset button on the message template to use default settings for that message template.

  4. Click Save .