Create a custom theme for the NetScaler Gateway logon page

Last published : Sep 03, 2026
You can use the GUI to create a custom theme for the logon page for NetScaler Gateway. You can also leave the default theme or use the Citrix Workspace app theme. When you choose to apply a custom theme to the logon page, you use the NetScaler Gateway command line to create and deploy the theme. You then use the GUI to set the custom theme page.
You configure the custom theme page by using NetScaler Gateway global settings.
You can use this feature with the following versions of NetScaler Gateway:
  • NetScaler Gateway 10.1
  • Access Gateway 10, Build 73.5002.e (you must install this build after Build 71.6104.e to use this feature with Endpoint Management Versions 2.5, 2.6, or 2.8)
  • Access Gateway 10, Build 71.6104.e
Related information
Integrate the Citrix Secure Access client with Citrix Workspace app

Create and deploy the custom theme by using the CLI

To create and deploy the custom theme by using the command line:
  1. Log on to the NetScaler Gateway command line.
  2. At the command prompt, type shell.
  3. At the command prompt, type mkdir /var/ns_gui_custom; cd /netscaler; tar -cvzf /var/ns_gui_custom/customtheme.tar.gz ns_gui/*.
  4. Use the configuration utility to switch to the custom theme and then make customization changes under /var/ns_gui_custom/ns_gui/vpn. You can:
    • Make edits to the css/ctx.authentication.css file.
    • Copy a custom logo to the /var/ns_gui_custom/ns_gui/vpn/media folder. Note: You can use WinSCP to transfer the files.
  5. If you have multiple NetScaler Gateway appliances, repeat Steps 3 and 4 for all appliances.